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Reliability 


Varies. May drip 
& leave stains. 


Superb. 

Automatic reminders 
without even running Relish. 


Versatility 


Limited. Good on 
hotdogs & hamburgers. 


Extensive. Categorize, 
schedule, & revise with ease. 


Unprecedented. Instantly & 
automatically saves information. 


Integrity 


Questionable. Must keep 
on ice when not in use. 


Cutting edge. A true PM solution 
based on client-server architecture. 


Archaic. Requires 
manual application. 
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Mroducing two powerful 
newaigumentsTor OS/2. 



The new 32-bit 1-2-3 and Freelance 
Graphics for OS/2. Every bit as 
powerful as the system they’re 
designed for. 

The new 1-2-3® Release 2 and Freelance 
Graphics® Release 2 you’ve been waiting for are 
here. These are the only major applications made 
specifically for OS/2® to unleash the full power of 
32-bit architecture. And designed to put OS/2 
users in business like never before. 


and Freelance Graphics] borrow from the best 
features of their DOS and Windows counterparts, 
while bringing out the best of Big Blue’s 32-bit 
operating system’.’* In fact, there’s no other 
software that optimizes OS/2 like these two. 

1-2-3 and Freelance Graphics also offer inno¬ 
vative features. Like Smartlcons™ easy one-click 
shortcuts to your most frequently used functions. 
Unique integration so seamless you’ll think you’re 
working with one program, instead of two. And 
hotlinks that automatically update data from 
one program to the other. 


With 1-2-3 and Freelance Graphics, 


you can finally have 


urapt 

itall 


All the power of the world’s leading spread¬ 
sheet. Plus all the simplicity of the top presentation 
graphics program. Plus all the things you wanted 
OS/2 for in the first place. Like multitasking, 
multithreading, drag-and-drop support, and 
the Workplace Shell™ (which you won’t find 
using DOS or Wmdows™ applications on OS/2). 

BYTE Magazine proclaims: “[Lotus® 1-2-3 


Two great applications. No waiting. 

Of course, to truly appreciate the power of 
1-2-3 and Freelance Graphics for OS/2, you should 
see them for yourself. Just call 1-800-TRADEUP, 
ext 8821,** for a free 1-2-3 for OS/2 demo disk, 
or for more information on Freelance Graphics 
and 1-2-3. 

And find out how, together, 1-2-3 and 
Freelance Graphics create a win-win solution for 
everyone on OS/2. 


Lotus 


1-2-3 and Freelance Graphics 

Spreadsheet and Presentation Graphics for OS/2 


*BYTE Magazine 3/93. **In Canada, call l-800nO-LOTUS ©1993 Lotus Development Corporation, 55 Cambridge Parkway, Cambridge, MA 02142. All rights reserved. Lotus, 1-2-3 and Freelance Graphics are registered trademarks 
and Smartlcons is a trademark of Lotus Development Corporation. OS/2 is a registered trademark and Workplace Shell is a trademark of International Business Machines Corporation. Wmdows is a trademark of Microsoft Corporation. 
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Ieasons Why You Should Be Using 
Describe Word Processor 4.0 SE 


Reasons Why Yi 
Describe Word 


Q DESCRIBE IS THE ONLY WORD 
PROCESSOR MADE ESPECIALLY 

FOR OS/2. Q With Background printing, 
you can print a document and get back to 
work instantaneously. Q Character 
Manager’s the easy way to set special charac¬ 
ter definitions. Q With the text box tool you 
can add copy to a picture frame. Q You can 
take advantage of DeScribe’s interactive defin¬ 
itions dictionary and thesaurus, as well as 
define and edit the Group dictionary with your 
unique company or technical language. 

Q DeScribe’s multitasking and multithread¬ 
ing let you work on multiple documents all at 
once. □ BUBBLE HELP ELIMI¬ 
NATES GUESSING AT CONFUS¬ 
ING ICONS AND SYMBOLS. 
fl Master Document Manager 
lets you control the index, the 
table of contents, and page num¬ 
bering across multiple files. B Describe has 
always been an innovative leader - and always 
will be. ED You can create and name styles 
from previously formatted text. QQ More than 
100 import/ export text and graphic filters 
open a world of possibilities. m Edit concur¬ 
rent varying magnifications of the same docu¬ 
ment. B You can reverse, rotate, and even 
print colored text. [Q DESCRIBE HAS 
BEEN CHOSEN BY PC COMPUTING AS A 
FINALIST FOR ITS 1992 MYP AWARD 
FOR WORD PROCESSING. 
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Text line 15. page I. Font Times 1?/H Style: VDocument 


Undoes document changes 
you made since you last 
saved the file. 


EE You’ll be in good company with a number 
of Fortune 100 corporations. EE Mail merge 
is easier than ever. EE Automatically print 
repeating text (like CONFIDENTIAL) on your 
document pages. EE Unlimited UNDO 
restores your work step by step, all the way 
back to the last time you saved the document. 

EE Threaded snapshots 
automatically back up 
your work, sparing you 
from the results of system 
crashes. □ Dropped capital letters are a 
click away. ES True hierarchical stylesheets 
exploit an inheritance structure for unsur¬ 
passed document formatting. 

ES YOU’LL GET A FREE UPGRADE WITH 
DESCRIBE WORD PROCESSOR 4.0 SE - 
THE ONLY SUBSCRIPTION EDITION IN 
THE INDUSTRY. ES Both Signature and 
Two-up printing work together to create 
booklet formats. ES Output is easier than ever 
with drag and drop printing of either individ¬ 
ual or simultaneous multiple documents. 

ES DeScribe’s novice mode simplifies the 
learning curve. 
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|gi TOOL ICONS JUST 

I i THE WAY YOU 
| WANT WHERE 
YOU WANT. 

ES The style 
palette puts fast 
dynamic text for¬ 
matting at your 
fingertips. EE DRAG AND DROP DOCU¬ 
MENT ICONS MAKE IT FAST AND EASY 
TO CREATE BOILERPLATES. 

S3 Only Describe Word Processor 4.0 SE 
gives you unparalleled text control, so you can 
prepare documents your way - any way you’d 
like. 03 Creating first drafts is a breeze with 
convenient draft and outline modes, as well as 
bulleting and numbering functions. 

ED Describe Word Processor 4.0 SE is not the 
first 32-bit word processor - Describe 3 0 32 was! 
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REXX, Wise, and Videoscape 

W ell, well, well. Here we are again, my friends. Another exciting 
issue. Our REXX issue came along very nicely. I got a call from 
Dave Hock of UCANDU Software who is releasing a new prod¬ 
uct into beta... Visual Programming with Rexx. Don’t confuse this with 
IBM’s VREXX. This product has some of the functionality of Microsoft’s 
Visual Basic, but it goes beyond. Actually, as a programmer by trade, I’m 
really quite enthusiastic about the onslaught of visual programming prod¬ 
ucts. Here’s another bit of news . . . There will be a visual-type-basic 
product for OS/2 from Knowledge Ware by the third quarter. I’ll let you 
know how the beta looks as soon as it gets dropped. 

And the winner is ... 

I thought long and hard about the OS/2 Book of the year award. From the 
many new-user books to the many technical books, I had to choose 
Robert Orfali and Dan Harkey’s Client Server Programming with OS/2 
2.0 (2nd Edition, ISBN 0-442-01219-5) The writing style is clear and in¬ 
formative. It stresses programming by example throughout its 1,088 
pages. There is much to learn here and the book offers it in a very 
straightforward and entertaining way. This latest edition contains over 
600 new pages covering: SOM & WPS Class Libraries; DRDA using 
DDCS/2; new communications programs, including Novell’s Netware Re¬ 
questor, TCP/IP, and CPI-C; and the 32-bit C set/2 Compiler. 

The first OS/2 Beta 2.1 code looks pretty good. Here are two tips: 1) If 
you’re experiencing problems running Windows or Seamless in the beta 
drop, you’ll need to rename the GDI.EXE to OS2GDI.EXE. That should fix 
it. 2)If you’re experiencing problems exporting TIFFs, EPSs, and AIs in 
COREL DRAW 2.5, you’ll need to contact them for the patch. And speak¬ 
ing of computer graphics, we will be seeing a hardware review of the 
new 24-bit color card, in the next issue. 

The lead article of this issue was done by Donna Campanella, Heroine 
of the Unattended. The issue of the time involved in installing a desktop 
operating system becomes more vital as time and capabilities go. While 
the 27 disks of OS/2 Beta 2.1 took less than an hour to install, I would 
much rather have been writing, reading, or even (yech!) balancing my 
checkbook. I hope you enjoy this issue. Regards, Joel. 


Joel Siragher 


Primed In the USA. by: EDISON lithographing COBP. ( 212 ) 7412212 / (201) 902 9101 
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EDITOR'S CORNER 


I n discussions about OS/2, one of the many recurring themes 
centers around the argument that OS/2 is only for develop¬ 
ers, with little or no support for the average user. I speak 
mostly in terms of native OS/2 applications, for this is how 
many judge OS/2’s penetration. I, like many, do not consider 
OS/2’s ability to run Windows a selling point for OS/2, since I 
feel that Windows is sufficient to run its own applications. The 
ability to run Windows allows the OS/2 user to plug up some of 
the holes not yet supported by native OS/2 applications. Native 
applications will attract users to OS/2, not OS/2’s ability to sup¬ 
port Windows, and therefore Windows applications cannot be 
considered when discussing the class of supporting applica¬ 
tions targeting the average user. 

Considering that OS/2 is making its appearance in an already 
heavily onesided marketplace, it is very difficult to decide what 
indicators should be considered when determining the viability 
of OS/2. With such an amorphous target, it is often necessary to 
look for trends rather than hard numbers which provide for us 
a possible future. 

While the number three million has been thrown around a 
lot — the number of shrink-wrapped copies sold so far — it is 
difficult to judge the impact this has had. How do these three 
million copies affect the marketplace? While many companies 
have committed to creating an OS/2 version of their products, 
we are still waiting for many of these companies to make good 
on their commitments. I, like many of you, desire some kind of 
early indicator to suggest the future of OS/2, to let me know 
whether or not the time we have invested in OS/2 will bear 
fruit.For an answer, we can fall back on Newtonian mechanics. 
The precise law is: acceleration = force / mass. Inertia is the 
ability of matter to resist acceleration when acted on by forces, 
and its measure is mass. Therefore, the more mass, the larger 
the inertia. The larger the inertia, the more force needed to ac¬ 
celerate the mass. 

The same principle applies when we are interested in judg¬ 
ing the effectiveness of OS/2 in the marketplace. We need to 
look at systems that exhibit small amounts of mass. These are 
the systems that can be early indicators of the future. If these 
smaller systems are accelerating, then there is potential for the 
larger ones to do the same. Inertia, in this case, refers to a seg¬ 
ment of the computing society in its acceptance of OS/2. 


The last indicator to look at, and the one most often looked 
at first, is the availability of shrink-wrapped applications. Here, 
with the general computing community as a whole, we are 
dealing with the largest mass, and one that needs several other 
strong forces to act upon it before it will accelerate. It is here 
that we often get lost in the catch-22 argument that an operat¬ 
ing system needs applications for it to be successful, and that 
developers do not want to develop for an operating system if it 
will not be successful. 

How is this stalemate broken? Where can we find relief? 

While researching possible methods to measure OS/2 pene¬ 
tration into the market, I have found that systems which exhib¬ 
it a small amount of mass are the most profitable to study for an 
early warning as to the success or failure of OS/2. The smallest 
system generally recognized by the computing community that 
can suggest the possible direction of OS/2 is the shareware and 
public domain market. Changes brewing in the market should 
first be displayed here, for here it is that we find the hardcore 
users struggling to create an environment where it has not yet 
become profitable. It is here that the frontier is created. As this 
area grows, it eliminates the reluctance of developers to devel¬ 
op commercially available applications and, sooner or later, the 
stalemate is broken. Fortunately, OS/2 is thriving in this area, 
and has been since the emergence of OS/2 version 2.0. To prop¬ 
erly represent this area, we have assigned Lou Miranda to man 
the Shareware column. We are very excited to have Lou navi¬ 
gate you through the gigabytes now available in OS/2 share¬ 
ware. Do not be mistaken; this is no small job! 

The next system on the food chain is the trend for the avail¬ 
ability of tools for developers. Undoubtedly, we are now seeing 
the most fruitful areas of OS/2 right now. The array of develop¬ 
ment tools now available is growing so fast that I have had diffi¬ 
culty keeping up with all of the products available and have cre¬ 
ated a new department to track and catalog the programs 
available for developers. 

And only now are we starting to see more and more shrink- 
wrapped applications becoming commercially available. The 
community has been stirred and is beginning to awaken. The 
early indicators are positive. I feel confident that IBM and OS/2 
are the future of personal computing. 

Brett Kotch 
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noise...we've got 'em. 

Get "System Sounds for OS/2 - 
with these unheard of features: 

<]») Hear sounds for over 40 events. 
<1J Make any key on your keyboard 
sound off at your command. 

<]») Use over 50 included audio 
effects from PROSONUS' 

Mr. SoundFX T . M 
<|») Record your own sounds. 

All you need is an audio card 
supported by MMPM/2 on OS/2 2.1 
or 2.1 beta. Order before July 1 st 
for just $49! 


CALL NOW 

407 - 392-7743 

BOCA RATON 




CA Soft 


Powerful Command Line 
Utilities for OS/2 & DOS 

LJV UTILITIES 


A SUPERIOR ALTERNATIVE TO THE STANDARD 
OS/2 OR DOS COMMAND LINE UTILITIES. 

High performance utilities created for those who still 
need to use the command line interface. Features 
include: 32-bit code (OS/2 2.xonly), color support, 
HPFS long filename and network support - [a must 
for the programmer]. Includes VCD, a visual 
change directory utility: RFD, a tool to remove entire 
trees of files. FCOMP, a source file compare utility: 
VCOMP, a binary file compare utility; UPDATE, a 
tool to update files that have changed; and ATTR, 
BGREP, ERA, FF, FREE, LJET, LWHAT, PERF, 
SWEEP, TAB, TOUCH, TREE, and VDIR. 

Introductory Price : $49.95 (US) 

LJV CONSULTING 
P.O. BOX 86 

MOORPARK, CA 93020-0086 
(805)529-1466 


Need more flexibility at the OS/2 prompt? More power in your batch files? 
Then you need... /? 


bif version* 

JP Software’s Enhanced \noivavailable! 
Command Processor for OS/2 

40S2 replaces the OS/2 command processor (CMD.EXE) with 
a complete new interface, fully compatible with existing OS/2 commands. 

It makes the [C:\] prompt friendly, powerful, and easy to use. 



Full featured command line editing, command 
history, and recall. 

Over 40 new commands to make the command 
line a truly productive tool. 

Dozens of powerful new batch commands and 
functions, plus faster batch execution. 

Only $89 bundled with 4DOS, JP Software’s 
award-winning command processor for DOS 
(40S2 only, $69; $29 for current 4DOS users). 


Aliases to create new or shorthand commands 
for common operations. 

Significant enhancements to most standard 
OS/2 commands. 

Complete, cross-referenced, on-line help. 

Shareware copies available on CompuServe (GO 
JPS0FT, library 10/JP Software) and many BBSes. 

Fully compatible with 4DOS and CMD.EXE, and 
with OS/2 versions 1.2,1.3, and 2.0. 


To order, call 800-368-8777 (order line), 617-646-3975, or 617-646-0904 (fax) 


JP 


software 


P.O. Box 1470, East Arlington, MA 02174, USA 


40S2 is a trademark and 4D0S ® is a registered trademark of JP 
Software Inc. OS/2 ® is a registered trademark of IBM Corporation. 
Other company and product names are trademarks of their 
respective owners. Copyright ©1993, JP Software Inc. 
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REMOTE/UNATTENDED INSTALLATION 

OF OS/2 


P erhaps the greatest penalty for today’s complex software is 
that installations have become quite cumbersome. For 
home users or standalone computers the biggest problem 
may be enduring the monotony of swapping diskettes, but for 
large organizations, it’s just plainly not practical to devote valu¬ 
able time and effort to playing disk jockey. Fortunately, there is a 
better way for OS/2: it can be installed from almost anywhere — 
diskettes, CD-ROM, a LAN, another hard disk, or any virtual de¬ 
vice that looks like a disk. IBM claims that the install program can 
use any device that can be made to look like a disk with a sup¬ 
ported file system. For standalone computers, a potential remedy 
for cumbersome installations lies with CD ROM technology. But 
for large organizations, installations via a LAN server can provide 
a very effective solution. Having the installation files available on 
a LAN server also comes in handy 
for easy later re-installation or se¬ 
lective installation. 

This article concerns the re¬ 
mote installation of base OS/2, the 
Service Pak and Extended Ser¬ 
vices, with a focus on using a 
Novell Netware server and a Nov¬ 
ell Netware requester client. 

When we tackled this, our project 
goals were to have the installation 
as unattended as possible and to 
make the installation process flex¬ 
ible enough to take care of the dif¬ 
fering workstation configurations 
(new machines, existing OS/2, 
version 1.3 machines, DOS ma¬ 
chines, plus differing types of 
hardware). Sub-goals were to 
make the workstations consistent 
in an effort to reduce later sup¬ 
port headaches, and to have a set 
of boot diskettes that we could just pop into a machine and run 
whatever piece of the installation (base OS/2, Service Pak, or Net¬ 
ware Requester) was desired. 

The first bit of advice for anyone wanting to automate OS/2 
installation is to get the IBM Redbook entitled OS/2 Version 1.0 
Remote Installation and Maintenance (IBM publication number 
GG24-3780). It discusses remote installation for IBM LAN, Nov¬ 
ell, and TCP/IP networks and provides the majority of what you 
need to know. It also contains information on Remote Multiple 
Printer Installation Application and using the Corrective Service 
Facility for distribution of corrective service diskettes. In addi¬ 
tion, the publication includes a diskette with the REXX com¬ 
mand files and utility programs discussed in the book. 

The Redbook describes both dialog-driven and response file 


installation. The dialog-driven installation uses the same installa¬ 
tion program as the normal OS/2 install, but eliminates the need 
to feed diskettes. All questions asked by the installation proce¬ 
dure must still be answered during the install. The response file 
method uses a different installation program and has the ability 
to read a response file containing predefined answers to OS/2’s 
installation questions. If your goal is to make the installation as 
unattended as possible, choose the response file method. 

At the minimum, you could simply invoke the install, or you 
could get quite fancy and build in options to partition and/or 
format hard drives, use customized response files for users or 
use a basic response file with an option to override only some 
keywords for specific users, execute programs before or after 
the installation, add lines to CONFIG.SYS, add functionality to 

install/de-install additional soft¬ 
ware — the list goes on. 

INSTALLATION PROGRAMS 

IBM provides several files to help 
with remote installation. They 
are part of the CID (Configura¬ 
tion Installation Distribution) 
utility. Files include: 

SEIMAGE - creates a subdirecto¬ 
ry structure on the installation 
server 

SEDISK - creates the OS/2 instal¬ 
lation disks DISK_0 and 
DISK_1 

SEMAINT - creates a minimal 
OS/2 version 2.0 seed on a tar¬ 
get machine 

SEINST - this program, docu¬ 
mented, is in the Redbook as 
“for use in future product implementations” ; recommenda¬ 
tions are to use RSPINST instead 

These files are found on OS/2 installation disk 7 in a bundle’ 
file called CID. To unpack the files, place diskette 7 in drive A: 
and type UNPACK A:CID from an OS/2 command prompt. The 
files will be unpacked to the hard drive’s \OS2\INSTALL subdi¬ 
rectory unless an alternative directory is specified. 

The more important installation files are SYSINST2.EXE and 
RSPINST.EXE. SYSINST2.EXE, found on OS/2’s installation diskette 
1, is the standard OS/2 2.0 installation program. It will, however, 
perform a dialog-driven installation from diskette or from a redi¬ 
rected drive if the first parameter specifies the disk drive and di¬ 
rectory where the OS/2 installation source files are located. 



Donna Campanella 
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REMOTE/UNATTENDED INSTALLATION OF OS/2 


RSPINST.EXE, found in the OS2\INSTALL directory or on diskette 
7, has the additional ability to read a text response file containing 
keywords and values. By using RSPINST instead of SYSINST2, the 
installation can be made more unattended. Presentation Manager 
is not available during a response-file installation, so the installa¬ 
tion occurs in a non-graphical, full-screen session. 

PREPARING THE SERVER 

To organize the files needed, it’s probably easiest to create a 
“top level” directory, such as OS2_INST, and add subdirectories 
as needed. For example, under OS2_INST, for an advanced Net¬ 
ware installation, you might have: 

OS2IMG - OS/2 base installation disk images, created by the 
SEIMAGE utility 

INSTALL - customized command files 


The following Netware mappings (as recommended by the 
Redbook) can then be used during the installation: 

MAP I:=SERVERNAME\SYS:\OS2_INST\INSTALL 

MAP R: =SERVERNAME\SYS:\OS2_INST\REXX 

MAP N:=SERVERNAME\SYS:\OS2_INST\NWFILES 

MAP Z:=SERVERNAME\SYS:\OS2_INST\OS2IMG 

Z: can be mapped as necessary, depending on what is being 
installed: 

MAP Z:=SERVERNAME\SYS:\OS2_INST\OS20SP for Service 
Pak 

MAP Z:=SERVERNAME\SYS:\OS2_INST\OS20ES for Extended 
Services 


REXX - REXX system files copied from an OS/2 2.0 machine 
and the Redbook diskette 

NWFILES - Netware Requester files unpacked from a Netware 
Requester disk or copied from an OS/2 2.0 Netware client 

OS20SP - OS/2 Service Pak disks created by XCOPY-ing each in¬ 
stallation diskette 

OS20ES - OS/2 Extended Services created by XCOPY-ing each 
installation diskette 
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OS/2 Files 

No matter what additional functionality you incorporate into 
the installation, one necessary step is to place the OS/2, ver¬ 
sion 2.0 image files on a network server. The installation direc¬ 
tories are not required to be in any specifically named directo¬ 
ry, but all subdirectories must be created within the same 
directory. You could do this manually, however the SEIMAGE 
utility aides with creating the correct file structure on the serv¬ 
er. SEIMAGE creates the subdirectories for each of the OS/2 in¬ 
stallation disks, copies all files, and prompts for the next 
diskette. 

To establish OS/2, version 2.0 disk images on a Novell server 
(assuming the directory SYS:OS2_INST\OS2IMG exists and Z: 
is mapped as MAP Z:=SERVERNAME\SYS:OS2_INST\OS2IMG) 
execute: 

SEIMAGE /SA: /T:Z:\ (/s specifies source /t specifies target) 

This produces a directory structure similar to the following: 

SYS:OS2_INST\OS2IMG 

I 

|-DISK_1 

|-DISK_2 


-DISK. 15 

-PMDD.l 


|-PMDD.5 

The Redbook suggests granting users access to these directo¬ 
ries; however, instead of modifying everyone’s network account 
and login scripts, it is probably preferable to set up a separate 
OS2.INSTALL account having read and file scan access to the 
OS2.INST directories. This provides added security in that dur¬ 
ing their normal day-to-day network usage, users cannot see the 
OS2.INST directory. If specific users need to override some key- 
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words in a general response file, the Redbook shows a way of do¬ 
ing this via an INCLUDE= statement and mapping the user’s 
home directory. 

Rexx 

If REXX will be used to customize the installation, REXX must be 
installed on the server in a path that is accessible to the client 
workstation, since OS/2, version 2.0 is not on the client machine 
at the time the programs need to run. To provide access to 
REXX for client workstations, place REXINIT.EXE, REXX.DLL, 
REXXINIT.DLL, REXXAPI.DLL, REXXUTIL.DLL, REXH.MSG and 
REX.MSG on the server in the OS2_INST\REXX directory. Dur¬ 
ing the install, MAP R:=SERVERNAME\SYS: OS2_INST\REXX, 
and include R: in the LIBPATH= and SET DPATH= statements in 
the CONFIG.SYS of the client workstation. 

Netware 

If Netware Requester will be installed on client workstations as 
part of the process, create the NWFILES subdirectory under 
OS2_INST and place the files from the Netware Requester disk or 
from an existing OS/2, version 2.0 Netware requester worksta¬ 
tion into this directory. During the install, MAP N:=SERVER- 
NAME\SYS:\OS2_INST\NWFILES. The Redbook provides a com¬ 
mand file to help install the Netware files onto the client 
workstation. It demonstrates calling this command file at the end 
of the OS/2 installation via the USEREXIT keyword in the re¬ 
sponse file. Since this generated errors at the conclusion of the 
install, we ran the command file before the Service Pak installa¬ 
tion instead. The sample on the Redbook diskette includes code 
to walk through the client workstation’s CONFIG.SYS and add 
Netware statements regardless of whether they are present; how¬ 
ever, this short code fragment demonstrates adding C:\NETWARE 
to the PATH statement only if it is not already there. 


do while lines('C:\C0NFIG.SYS') 
it - lineinf'C:\C0NFIG.SYS') 
it * translate(it) 
if pos('SET PATH',it) <> 0 then 


/* Do until end of file */ 
/* Read first line */ 
/* Make everything UPPERCASE */ 
/* If SET PATH is in line */ 


if pos('C:\NETWARE;',it> = 0 then /* if C:\NETWARE not in PATH */ 
it * it || 'C:\NETWARE;' /* Add C:\NETWARE */ 

call lineout 'C:\C0NFIG.NEW', it /* Write line to CONFIG.NEW */ 
end 


call stream 'C:\C0NFIG.NEW', ' c', f close' 
call stream 'C:\CONFIG.SYS'c'close' 

If you haven’t already, you should investigate REXX — what 
can be done with just these few lines shows REXX to be a very 
powerful and elegant tool provided free with OS/2. 


Installation Files 

The remote installation program, RSPINST.EXE, and any response 
files, should reside in OS2_INST\OS2IMG. You can create several 
response files based on user needs, then use a pre-installation 
REXX command file to prompt for which configuration to use. 
For example, FULL.RSP may be a full installation, whereas LIMIT¬ 
ED. RSP may specify not to install OS/2 games and productivity 
applications. OS/2, version 2.0 provides a sample self-document¬ 
ing response file named SAMPLE.RSP. This file, which can be 


foimd in the \OS2\INSTALL directory or on one of the installation 
disks, can be used as a basis to create your own response files. 

LAN TRANSPORT DISKS 

Another very important step involves modifying the first two 
diskettes of the OS/2 installation package (actually, only the sec¬ 
ond disk requires modification) to create what the Redbook calls 
LAN TRANSPORT (LT) disks. The LAN Transport diskettes pro¬ 
vide a minimal network connection to access the OS/2 installa¬ 
tion files on the network server. If you can obtain a connection 
in some other manner, that would probably work as well, but for 
cases such as brand new machines or machines whose disks 
need to be repartitioned, you cannot assume network files are 
present on the client workstation. Creating the LT disks involves 
making a diskcopy of first two installation diskettes, adding files 
for network access, modifying the PATH, LIBPATH, and DPATH 
in CONFIG.SYS, and adding an environment variable to specify 
the location of the remaining OS/2 installation files. 

The changes required to CONFIG.SYS’s environment state¬ 
ments will depend on your individual needs. In our case, the 
statements ended up as: 


LIBPATH=.;A:\;\;\0S2\DLL;R:\;Z:\DISK_2; 

SET PATH=A:\?\;\0S2;\0S2\SYSTEM;\0S2\INSTALL;Z:\DISK_1;H:\; 
SET DPATH=A:\;\;\0S2;\0S2\SYSTEM;\0S2\INSTALL;Z:\DISK_1;R:\; 
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REMOTE/UNATTENDED INSTALLATION OF OS/2 


The path to Z:\DISK_1 was added for access to FDISK, 
Z:\DISK_2 for access to CHKDSK and FORMAT, and H:, mapped 
via Netware login script, for Netware utilities on the server. 
Adding the line SET SOURCEPATH=Z:\ to CONFIG.SYS tells the 
OS/2 installation program where to find the OS/2, version 2.0 
disk images. It is an alternative to hard coding 
OS2_SHELL=SYSINST2.EXE Z:\ in the CONFIG.SYS. SOURCE- 
PATH can also be specified in the response File. 

Statements to load the Netware drivers must also be added to 
the LT disk’s CONFIG.SYS: 

REM 

REM NetWare Requester statements BEGIN — 

REM 

DEVICE»A:\LSL.SYS 

REM Network adapter card 

DEVICE=A:\TOKEN.SYS 

REM DEVICE=A:\ROUTE.SYS - commented out since 
REM it was not needed in our case 
DEVICE=A:\IPX.SYS 
DEVICE=A:\NWREQ.SYS 
IFS*A:\NWIFS.IFS 
RUN=A:\NWDAEMON.EXE 
RUN=A:\DDAEM0N.EXE 
REM 

REM - NetWare Requester statements END — 


Most of the necessary installation files can reside on the net¬ 
work server. However, some files must exist on the LT disks. 
The network device drivers must be placed on the second LT 
disk, and one problem is that there is very little free room on 
this disk. It is fortunate if all the hardware is fairly similar, since 
complications arose for us when a change in token ring boards 
required a change of device drivers. Some files can be deleted 
from the second disk, and this is where the file OS2FLIST.TXT 
came in handy. This file can be found on IBM’s CompuServe 
support forums (last check found it as OS2FL2.ZIP in lib 17 of 
the OS2SUPPORT forum). Since our hardware was all either 
IBM Model 70s or various Dell models, we deleted several of 
the .BIO files for machines such as the IBM model 80 and 90. If 
you are sure you do not want to be able to screen print during 
installation, the file PRINT01.SYS can be removed — just re¬ 
member to REM out the BASEDEV= line in CONFIG.SYS which 
loads this file, or error messages will be displayed during boot 
up when the file cannot be found on the diskette. For Netware, 
the following files need to be on the second LT disk: NWCON- 
FIG.DLL, IPXCALLS.DLL, NWCALLS.DLL, LSL.SYS, TOKEN.SYS, 
NWDAEMON.EXE, DDAEMON.EXE, NWREQ.SYS, NWIFS.IFS, 
IPX.SYS, and potentially ROUTE.SYS. You’ll probably find that 
NET.MSG and NETH.MSG are too big to fit on the disk. 

INVOKING THE INSTALLATION 

For a standalone workstation, you could probably simply re¬ 
place SYSINST2.EXE with RSPINST.EXE, create a response file 
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called OS2SE20.RSP and change the CONFIG.SYS statement 
from SET OS2_SHELL=SYSINST2.EXE to SET OS2_SHELL= 
RSPINST.EXE A:\OS2SE20.RSP However, to be able to log in to 
the network, map drives, and/or ask some initial pre-installation 
configuration questions or to prepare the hard drive in any way, 
you need more flexibility. Replace the SET OS2_SHELL= SYS- 
INST2.EXE line with SET OS2_SHELL=CMD.EXE /K A:START- 
INS.CMD (leave PROTSHELL=SYSINST1.EXE). 

After booting and loading network drivers, the LT diskettes 
will start an OS/2 command prompt and run the specified com¬ 
mand file, in this case STARTINS for START INSTALL. The com¬ 
mand file is the starting point for remote installation of OS/2, 
and any further command files needed during the installation 
can be run from the network server. One caveat is that the com¬ 
mand file specified in the OS2_SHELL statement cannot be a 
REXX command file since REXX is not available yet. 

If REXX is to be used to customize the installation process, 
the REXINIT.EXE program is needed to initialize the REXX func¬ 
tions and load REXX DLL’s on the minimally booted system. 
REXINIT is available on the disk which is included with the 
Redbook. The miminally booted system, however, will not 
quite have full REXX functionality. Problems were caused for 
the OS/2 installation programs when the lines “call rxfuncadd 
sysloadfuncs, rexxutil, sysloadfuncs ; call sysloadfuncs” were in¬ 
cluded in any pre-installation REXX command files, since addi¬ 
tional Presentation Manager functions are needed for REXX¬ 
UTIL. 

In the following example, STARTINS.CMD logs in to the net¬ 
work, maps the appropriate drives, initializes REXX, and in¬ 
vokes another command file, STARTRFI (which can contain 
REXX statements). Further command files reside on the net¬ 
work OS2_INST\INSTALL directory which is mapped to I:. 

0ECHO OFF 

REM Batch file called from 0S2_SHELL statement 
REM in CONFIG.SYS 

REM Cannot be a REXX command file as REXX is 
REM not installed when this batch file is run 

REM Check if already logged in to network 
IF EXIST R:\REXINIT.EXE GOTO INSTALL 

REM Log in and set up drives 

LOGIN SERVERNAME\OS2_INSTALL 

MAP I:=SERVERNAME\SYS:\OS2_INST\INSTALL 

MAP R: *=SERVERNAME\SYS: \0S2_INST\REXX 

MAP Z:=SERVERNAME\SYS:\0S2_IHST\0S2IMG 

MAP N:=SERVERNAME\SYS:\0S2_INST\NWFILES 

REM Start REXX and display message 
0ECHO ON 

DETACH R:\REXINIT 
6ECH0 OFF 


REM Run REXX command file to prompt for install options 
:INSTALL 
I: 

STARTRFI 


STARTRFI.CMD can then be tailored to meet your specific 
needs. To execute a dialog-driven installation, the command file 
could simply contain the command SYSINST2.EXE Z:\. To exe¬ 
cute a response-file installation, the command file could contain 
Z:\RSPINST Z:\OS2STD.RSP (don’t forget to SET SOURCE- 
PATH=Z:\ in CONFIG.SYS). Our command file got quite elaborate 
with options to partition and/or format the hard drive, remove 
certain installed software, save the existing STARTUP.CMD, save 
Communications Manager configuration files, and prompt for the 
desired OS/2, version 2.0 configuration (which determined 
which response file was used during the installation). Once a 
few initial pre-install questions were answered, you could walk 
away and let the installation continue unattended. 

SERVICE PAK and EXTENDED SERVICES 

As mentioned, the Service Pak can also be installed via the LAN 
with the commands: 

MAP Z:=SERVERNAME\SYS:OS2_INST\OS20SP 

Z:\FSERVICE.EXE /R:Z:\RESP0NSE.FIL /S:Z:\ — where FSERVICE is 

the OS/2 CSD install program which reads a response file, /R 
specifies the name of the Service Pak response file, and /S spec¬ 
ifies the base directory of the Service Pak (CSD) image. The Ser¬ 
vice Pak provides a default response file, but if you require any 
fancy processing, keywords are documented in the Redbook. 

In our case, in addition to loading base OS/2, the Service Pak, 
and Netware Requester, we also wanted to load Extended Ser- 
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vices from the network server. However, the installation for Ex¬ 
tended Services would not run from the booted LT disks — it 
would only run from a fully functional OS/2, version 2.0 
machine. 

Although most of the questions during the installation of 
base OS/2 can be eliminated by using a response file, the an¬ 
swers to questions regarding LAN addressing during installation 
of Extended Services are unavoidable. Nonetheless, it’s a great 
help to be able to pull the ES files from the LAN server. Once 
the workstation is installed and booted with OS/2, version 2.0 
and the network drivers, type the command file STARTES.CMD: 

SET SRCDRV=Z: 

LOGIN SERVERNAME\OS2_INSTALL 

MAP Z:=SERVERNAME\SYS:OS2_INST\OS20ES 

START /C Z:\ESINST invokes the Extended Services installa¬ 
tion program, ESINST, which uses the SET SRCDRV= environ¬ 
ment variable to locate the ES installation files. 

Because of our mixed environment of Novell and IBM IAN 
Server, some clean up work was needed after installation of ES 
to remove Novell device driver statements which would con¬ 
flict with the newly installed Extended Services. Our procedure 
ended up being the following: 


- Boot workstation with Lan Transport disks 

- Optionally repartition and/or reformat hard drive 

If hard drive is repartitioned, re-boot workstation with LAN 
Transport disks 

- Choose install base OS/2, version 2.0 

- After installation is complete, boot workstation with LAN 
Transport disks 

- Choose install Netware and Service Pak 

- After installation of Service Pak, boot workstation from hard 
drive 

- After the Workplace Shell desktop is built, run a command 

file to start Extended Services installation 

- After Extended Services installation, switch back to the 

session where STARTES was invoked and continue 
installation of LAN protocol information - Boot workstation 
from hard drive - Run REXX command files to customize 
desktop 

IBM recommends that after the OS/2 installation builds the 
Workplace Shell desktop, an immediate shutdown be per¬ 
formed. However, the procedures above indicate immediately 
rebooting with the LT disks after the base OS/2 install and in¬ 
stalling the Service Pak, then rebooting the machine and letting 
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OS/2 build the Workplace Shell desktop. This appeared to work 
fine for machines where the hard drive was reformatted; how¬ 
ever, it did not appear to work correctly when installing over 
existing OS/2, version 1.3 machines, generating various errors 
on boot up (C000005’s or messages indicating that the 
OS2KRNL file could not be found). The solution for this was to 
reboot after the base OS/2 install, to let OS/2 build the desktop, 
and then to shut down immediately and boot with the LT disks 
to install the Service Pak. If any errors are encountered during 
the installation, be sure to check INSTALL.LOG and 
SERVICE.LOG in OS2\INSTALL on the workstation. These log 
files often provide more information than the generic error 
messages received during installation. 

The finale of our installation was the use of REXX routines to 
add icons and program settings to customize the desktop. The fol¬ 
lowing short bit of REXX code demonstrates creating a desktop 
folder containing a program object for logging out of the network. 

/* Load REXXUTIL */ 

call rxfuncadd sysloadfuncs, rexxutil, sysloadfuncs 
call sysloadfuncs 

classname - 'WPFolder' 

title = 'General' 

location - '<WP_DESKTOP>' 

setup - 'OBJECTID-<GENERAL_FOLDER>;'||, 

'ICONFILE=D:\ICONS\FOLDERS.ICO ;• 

/* create object — replace if duplicate */ 

rc - SysCreateObject(classname, title, location, setup, 'R') 


classname = 'WPProgram' 

title * 'Logout' 

location = '{&&GENERAL_FOLDER&&> # 

setup - 'OBJECTID-<LOGOUT>;'|J, 

'EXENAME-C:\NETWARE\LOGOUT.EXE;'|J, 

'ICONFILE=D:\ICONS\NETWARE.ICO ;'|[, 

'ICONPOS-10,40;'||, 

'MINWIN-HIDE;'J |, 

'PROGTYPE=WINDOWABLEVIO;' rc * SysCreateObject(classname, 
title, location, setup, 'R') 

After developing these procedures, two of us installed on 
some 50+ machines over Christmas break while the majority of 
the staff was off. Since more machines were to follow, we 
turned the procedures over to our hardware/software installa¬ 
tion group and their feedback to us was that they were “very 
impressed with the REXX routines and that it has made the job 
of installing OS/2 very easy” Of course it’s easier — the entire 
installation process was reduced from requiring approximately 
45 disks to requiring only 2! ♦ 


Donna Campanella is employed as a Systems Software 
Specialist at a large insurance company and is active in a 
local computer user group where she leads an Operating 
Environments Special Interest Group. When her fingers aren't 
glued to the keyboard programming, she can be found sun 
bathing, aerobicising, or jumping out of airplanes. 
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T here are a lot of books about object ori¬ 
ented programming and C++. The basic 
problem with these books (if your goal is 
to learn about design) is that they are depen¬ 
dent on either a language or a specific imple- 
k mentation or revision level 
of a standard. Everything 
'we’ve learned about mod¬ 
ern software development, 
going back to the days when 
structured programming 
I*was king, suggests that de¬ 
sign is supposed to be inde¬ 
pendent of language. 

We’ve spent a couple of 
articles describing some 
of the basics involved in 
techniques to design ob¬ 
ject-oriented programs. 
Given the confines 
of space and 
deadlines for 
magazine 
articles, 
there is a limit to the 
depth and detail we can explore. Periodically, 
we’ll take a look at books that we’ve found 
valuable. Since most people have problems 
with the design phase of object-oriented tech¬ 
nology, it is nice to know there are excellent 
primary sources for additional information. 
This month we’ll cover two books that you 
should consider acquiring, if you don’t have 
them already. 



A Book About Design 

While there are some things another author 
might have done differently, Designing Ob¬ 
ject-Oriented Software (from Prentice-Hall) 
by Rebecca Wirfs-Brock, Brian Wikkerson and 
Lauren Wiener, starts with an explanation of 
the software crisis. The authors justifiably 
question the reliability of the existing base of 
software. Further, they remind us that soft¬ 
ware is never a “finish it and be done with it” 
experience. Fixes, patches, enhancements 
can all contribute to extending the life of a 
package beyond what was originally intended. 

Further, each new addition (fix, patch, 
change, new feature) adds interactions and 
complexity that can have the effect of making 
things worse instead of better. 


I suspect most of us are familiar with soft¬ 
ware that fits this particular mold. While I 
might prefer a bit more specific detail and ex¬ 
amples of the problems, the point is still valid 
— there IS a problem with software develop¬ 
ment today. 

The solution to the problem is another ap¬ 
proach to the design and development 
process. 

In the preface to their book the authors say, 
“[SJimply using an object-oriented program¬ 
ming language or environment does not, in it¬ 
self, guarantee miraculous results. “ They also 
say they tried “to take a practical down-to- 
earth attitude that can help....” They succeed¬ 
ed! The book is a practical guide to the design 
of good object-oriented applications. 

The authors point out that good software 
design, regardless of methodology, is an art 
form that requires practice. It requires desire 
and commitment to learn from past mistakes. 
It takes more than just hard work and disci¬ 
pline, it takes a bit of inspiration, too. 

The authors describe the abstraction 
process that is model based. Forgetting pro¬ 
gramming for a minute, we construct mental 
models to help us bring order to our world. 
We use these models as maps to aid both un¬ 
derstanding and predictability. This book ex¬ 
tends the thought process we use every day 
to help provide in-depth understanding of the 
world of objects. 

We’ve talked about design in some of these 
articles. The problem is that in this format 
we’re limited with respect to both time and 
space. It takes more than a few pages, once a 
month, to convey the ideas behind the skills. 
Further, it doesn’t hurt if you have a mentor, 
someone who has crossed the stream enough 
times in the past to know how and where to 
find the rocks. 

This book takes a project from specifica¬ 
tion through the various decisions that lead 
to an implementable design. Not only do the 
authors explain the correct choices, they 
also cover reasons why some decisions 
should be rejected. Their design method 
of choice is CRC cards (Class, Responsibili¬ 
ties, and Collaborations) which they clearly 
document. 

Designing Object-Oriented Programs 
should be a part of everyone’s library. While 
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you can’t ask the book a question, it does 
provide insight into the way experts think 
about object oriented design. 

The Basics 

“OK,” you say, “I’m not ready for object- 
oriented design yet. I need some basic ref¬ 
erences to help me understand what this 
is all about. Isn’t there something that I 
can use, too?” 

In that case, get a copy of David Tay¬ 
lor’s Object-Oriented Technology: A Man¬ 
ager's Guide (from Addison-Wesley). This 
book is one of the clearest introductions 
to the realm of objects I’ve seen. 

A soon as you see the word “manager” 
as part of the title, you should realize that 
this isn’t a book about programming. It is a 
relatively short book (140 pages) that you 
can read in an evening or two. Yet, when 
you finish, you’ll have a better feel for what 
the technology is and what it means. 

Taylor also starts with a recounting of 
the familiar state of affairs we call the 
“software crisis.” With history as a back¬ 
ground he begins to introduce the con¬ 
cepts of object-oriented development, 
starting with the first object-oriented lan¬ 
guage, Simula. The language was devel¬ 
oped by Dahl and Nygraad as a simulation 
tool. They constructed a concept of a pro¬ 
gramming module that was based upon 
the physical objects they intended to 
model. 

This was a departure from the function 
(or procedure) based code. It made sense 
because an object has a range of behavior 
to model; it also has to maintain informa¬ 
tion about its status. What Dahl and Ny¬ 
graad realized was that the problem itself 
supplies an organization for the solution. 

This means the concept of software ob¬ 
jects grew out of a simulation need to 
model the real world. The object neatly 
packages a way to represent and control 
behavior. There is a difference in mindset 
between the modeling-based approach of 
object technology and the traditional soft¬ 
ware approach (which is to make the 
computer perform a task). 

Taylor provides an ample framework, in 
a logical progression, that helps the read¬ 
er begin to develop the proper object-ori¬ 
ented mindset that is necessary in order 


to understand the past as well as future 
directions. 

This alone would be sufficient reason 
to read the book. However, Taylor goes a 
step further. He also provides a set of cri¬ 
teria to help evaluate the risks and bene¬ 
fits of the technology. 

The final chapter provides a glimpse 
into the future. What happens when we 
have true open systems based upon ob¬ 
jects? Then, according to Taylor, we will 
also have true mix and match software. 
He also briefly discusses the combination 
of objects and data bases (the object-ori¬ 
ented data base). 

I’d like to see a future revision of the 
book that spends a bit more time with the 
future than the current edition. However, 
the mere glimpse that he provides will be 
an eye opener for many. 

Coming attractions 

I’ve received quite a few requests from 
people who that wanted to know if there 
was a way to use some of the techniques 
of object oriented technology without an 
object oriented language. It probably 
comes as no surprise that there is. We 
need ways to deal with the primary con¬ 
cepts in object-oriented programming 
(encapsulation, polymorphism, inheri¬ 
tance, etc.). 

In previous articles we’ve said that the 
OS/2 Presentation Manager is an entry 
into the world of object. We ll begin to 
explore this in more depth and look at 
how we can take advantage of the object- 
oriented capabilities already available un¬ 
der OS/2, version 2.1. 

We’ve also spent some time with both 
Smalltalk and PARTS from Digitalk. We’ll 
take a look at these two packages in up¬ 
coming issues. 

We’re looking for class libraries. If you 
either have a class library or know of one, 
let us know. We’re planning a review of 
32-bit OS/2 class libraries in future issues. 

Finally, we’ll also begin to take a look at 
what it takes to create Workplace Shell 
objects. We’ll cover the basic concepts of 
IBM’s System Object Model (SOM): what 
it is, how it works, and how to use it. 

If there are other things you would like 
covered, let us know. ♦ 
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SLOPE 


By Bill Zinsmeyer 


BUILT BY ASSOCIATION 
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T he Workplace Shell, the user interface 
provided by OS/2, version 2.0, is a wel¬ 
come advancement over previous inter¬ 
faces created for Intel-based PCs. The Work¬ 
place Shell is object-oriented and in this case 
at least, the term object-oriented isn’t just a 
public relations slogan; it means some con¬ 
crete, tangible features to help the user. Drag- 
and-Drop functionality, different views of an 
object, templates, shadows, decreased reliance 
upon menus and easy customization of objects 
are just a few of the demonstrable benefits of 
the Workplace Shell. The aspect of OS/2 and 
the Workplace Shell we ll discuss this month is 
“Association”. 

Some Macintosh Background 

Perhaps some readers are migrating to OS/2 us¬ 
age from the world of the Apple Macintosh. 
Never feeling comfortable with DOS or Win¬ 
dows, you waited until there was something 
acceptably similar to the Mac before spending 
any significant time or money on PCs. This 
was a wise decision; the Workplace Shell was 
worth the wait, and your learning curve with 
OS/2 will actually be shorter than if you had 
adopted the habits and conventions appropri¬ 
ate for MS- Windows. And certainly some of 
the quirks of DOS can be annoying to those fa¬ 
miliar with the Macintosh. 

One tedious feature, for example (and one 
DOS users often accept without thinking 
about it), is the need to invoke an application 
first, and then to load in a data file after the ap¬ 
plication is up and running. In such a situation 
it’s not unusual to hear a Mac veteran com¬ 
ment, “Why is this necessary? On my Mac, I 
just have to click on my spreadsheet file and 
the system knows it has to activate the spread¬ 


sheet application and load in the data for me.” 
The same is true of word processors and hun¬ 
dreds of other applications. Well, much to the 
enjoyment of this user at least, the same feat is 
now possible with OS/2. 

Although the name of this magazine is not 
“Macintosh Monthly”, let’s discuss the Mac just 
a moment longer. In the Mac a data file is not a 
simple data file. A Mac file has two compo¬ 
nents: a data fork and an attributes fork. It is in 
the attributes fork that information such as the 
file’s appearance as an icon and the date and 
time created are stored. It is here also that in¬ 
formation is stored telling the system the file is 
associated with a certain spreadsheet applica¬ 
tion (or word processor or other application). 
The approach to file management under OS/2 
resembles the Macintosh strategy somewhat; 
in OS/2, the special information maintained 
along with each data file is called “Extended 
Attributes.” 

Extended Attributes, which were briefly 
mentioned in the first “Beginner’s Slope” arti¬ 
cle, can carry information such as the name of 
the person who created the file, the date/time 
stamp, the icon for the file and other charac¬ 
teristics. A key feature of OS/2 closely related 
to Extended Attributes is called “Association.” 
Association allows the system to recognize, as 
a data file is opened, that a certain application 
should be activated and the file loaded into 
that application. 

Of course, the same result can be accom¬ 
plished by dragging and dropping the file object 
on the application’s object, but drag and drop is 
not always convenient. If you have a special text 
editor that you greatly prefer, will that editor al¬ 
ways be located right next to the text files you 
want to edit? What if you wish to edit a word 
processor document or a spreadsheet file on a 
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floppy diskette; wouldn’t you then have to 
go locate the folder containing the correct 
application? Association can reduce a lot of 
this time and effort. 

Establishing an Association 

A fundamental point to remember is that 
the association between a data file and its 
application is best established through 
the settings of the application, not the 
file. With that in mind, let’s proceed. First 
of all, if the application in question has 
not been defined as an object (i.e., mi¬ 
grated to the Workplace Shell), then that 
must be done (use “Migrate Applications” 
in the System Setup folder). Now open 
the Settings Notebook for the application. 

The simplest and easiest way to build 
an Association is through the use of a 
naming convention. The Settings Note¬ 
book will have a tab labelled ASSOCIA¬ 
TION. Click on this tab (left mouse but¬ 
ton). The Association page will show two 
boxes near the top labelled AVAILABLE 
TYPES and CURRENT TYPES. Below 
these will appear a one-line box labelled 
NEW NAME and another box labelled 
CURRENT NAMES. It is here we establish 
the association between an application 
and data files. 



The reader at this point may be won¬ 
dering just what is meant by the term “ap¬ 
plication.” Does the principle of associa¬ 
tion only work with large software 
packages such as WordPerfect or Lotus 1- 
2-3, which consist of dozens of separate 
files? The answer is no, it’s not just pack¬ 
ages like that: Application as used here 
means any software that can be defined as 
an OS/2 executable (program) object. In 
fact, it’s probably better to experiment 


with Association using a small, one-file ex¬ 
ecutable at first. 

Most users of OS/2 will have the file 
PKUNZIP2.EXE available, since it often is 
provided along with the operating sys¬ 
tem. Sometimes it will not be available, 
depending on the options that were cho¬ 
sen during installation. If it cannot be 
found, try to obtain it or PKUNZIP.EXE, 
the earlier DOS version of this common, 
well-known utility. PKUNZIP2 would be 
an ideal program with which to try out as¬ 
sociation. This single file “application” 
will decompress any file that’s been creat¬ 
ed using the PKZIP or PKZIP2 data com¬ 
pression facilities. Files that have been 
compressed in this way usually have 
names ending in “.ZIP.” One or two 
“zipped” files will be needed to carry out 
this example. Bring up the Settings Note¬ 
book for the program, and on the Associ¬ 
ation page type “*.ZIP” in the field “New 
name.” Click on “Add” to move *.ZIP into 
the “Current names” box. Exit the Note¬ 
book, and the Association is established! 

Default Settings 

If one is building an Association based on 
a naming convention, try to select a 
unique naming scheme that does not fol¬ 
low an often-used pattern. For example, 
do not select *.DOC or *.SYS as a conven¬ 
tion. The reason for this is the new Asso¬ 
ciation might not become the default, as 
one would normally expect, if the naming 
convention is already in use by the sys¬ 
tem. How can one tell if the association 
has become the default as desired? Find a 
file that, due to its name or other charac¬ 
teristic, should be associated with a given 
application. Activate the pop-up menu for 
the file (click once with the right mouse 
button). Just as one would bring up the 
Settings Notebook, click on the arrow in 
the small box next to “Open”. 

The options shown in the cascade 
menu under “Open” are the different 
ways in which the file can be opened. If 
PKUNZIP2 has successfully been associat¬ 
ed with a .ZIP file, the Open options will 
be “Settings”, “PKUNZIP2.EXE” and “Sys¬ 
tem Editor.” A check mark will always ap¬ 
pear on this sub-menu, which indicates 
which option is the default action for 
“Open.” It’s even possible that “System 
Editor” will no longer show up, based on 
the name of the file and the fact that 
PKUNZIP2 has become the default. 


t?]P; 


a a 


ST iJjSsu 

Create another * 

Copy- 

Move... 

Create shadow 
■yjr i fielete... 

I LjJ Srtnt « 

pm_«prip 


If for some reason the default indicator 
is not pointing to the desired option, it 
can be changed. Bring up the Settings of 
the data file and turn to the Menu page. 
The first box, “Available menus”, will 
probably have two entries: “Primary pop¬ 
up” and “Open.” Select “Open” by click¬ 
ing on it once, then select “Settings”, the 
second of the three one-line boxes to the 
right. This will bring up a window enti¬ 
tled “Menu Settings.” Within this window, 
find the “Default Action” control. Click 
the downward sign at the right to reveal 
the default options, and here one can se¬ 
lect a different default. 



Unfortunately, even after the default 
open-action has been reset to the desired 
application, this may not be a lasting 
change, depending on how the file is 
used later. All changes made to the Ex¬ 
tended Attributes of a data file should 
only be considered temporary fixes be¬ 
cause quite a few applications go through 
a create-delete-rename procedure when¬ 
ever a data file is updated and saved. This 
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is why the establishment of an Associa¬ 
tion, and all subsequent adjustments to an 
Association, should always be attempted 
whenever possible through the settings of 
the application, not the data file. Let’s go 
over an example to illustrate how Extend¬ 
ed Attributes are often lost. 

Let’s suppose for a moment that the 
recommendation of this article is not 
heeded and *.DOC is used as the naming 
convention for association with the Word¬ 
Perfect DOS word processor. It’s quite 
likely that one will discover, by examining 
the open actions possible for a *.DOC file, 
that WordPerfect is available, but is not 
the default. If WordPerfect is made to be 
the default, by altering the settings of the 
file as described above, the new default 
action will continue only as long as the 
document is not changed and saved. If 
the file is updated, then WordPerfect — 
behind the scenes — actually creates a 
new file, deletes the old one, and re¬ 
names the new file to have the original 
name. This is transparent to the user, and 
causes no severe problems, but it does 
wipe out the Extended Attributes associ¬ 


ated with the original file. The original 
file, remember, has been deleted. 

The fact that the Extended Attributes 
(of which Association is a part) are lost 
during the save process of many applica¬ 
tions is not the fault of OS/2. It would be 
hard to imagine an operating system that 
would monitor every application and, if 
the create- delete-rename procedure were 
used, would transfer attributes from the 
old file to the new one of the same name. 
To do so probably would create more 
problems than it would solve. 

Of course, if Association and other 
properties are established only through 
the settings of the application, and no re¬ 
finements are attempted through the set¬ 
tings of a data file, then it becomes im¬ 
possible to lose the association. But if the 
Extended Attributes of a data file are al¬ 
tered, the operating system can only do 
so much to maintain them in an update- 
and-save process. (Would it be biased or 
unseemly to say that this is a good reason 
to purchase genuine OS/2 applications 
written for version 2.0?) Most of the re¬ 
sponsibility for maintaining attributes 



From the leader in OS/2 Screen Image Utilities; 

PmtScrn™ is an economical combination of four important utilities: 

1. Screen image print/capture, 2. Clipboard Viewer, 

3. Screen Blanker, 4. Date & Time Display 
PrntScm is the utility of choice: 

For Insurance Companies, Banks, Medical Facilities, and other businesses who need to 
output quality Black & White copies of the screen images displayed by their OS/2 PM apps. 
For authors, trainers, and courseware developers who need to include OS/2 Workplace Shell 
images in their material. 

PmtScrn is CUA compliant and LAN compatible. All internal operations are done "by the 
book" to provide the most stable and reliable product available. 

Includes OS/2 2.x (32-bit) and OS/2 1.3 (16-bit) versions. 

Available from major software resellers, or contact: 

MITNOR Software 
28411 E. 55th Street 
Broken Arrow, OK 74014 
Phone: (918) 357-1628 Fax: (918) 357-2869 


Prnt 

Scrn 


properly rests with the application in up- 
date-and-save situations. 

The loss of Extended Attributes can be 
inconvenient if it happens unexpectedly, 
so it’s better to try it out intentionally. It’s 
a good way to learn more about Associa¬ 
tion and attributes, and it can be fun (no, 
really, I’m serious). As an experiment, try 
assigning a new icon to a file, then update 
the file with a word processor, spread¬ 
sheet or whatever’s appropriate. In some 
cases the association with the new icon 
will be lost and in some cases it will re¬ 
main; perhaps from this you can deduce 
how different applications go about sav¬ 
ing a file. 

Another worthwhile endeavor is to es¬ 
tablish an Association based on a naming 
convention and then to change the name 
of a test file to fit the convention. Access 
the file through the drives folder to do 
this; do not rename it at a command 
prompt. Later, find a file whose name al¬ 
ready matches the naming convention 
and change it, as well. In these cases OS/2 
is alert to what’s going on and warns you 
that the Association based on the file 
name is being changed. 

Once you feel confident with Associa¬ 
tion and Extended Attributes, another ex¬ 
ercise to try is to attempt association 
based on file type rather than on a nam¬ 
ing convention. As with naming conven¬ 
tions, build the Association through the 
application. 

When association is brought about fol¬ 
lowing these guidelines, whether through 
naming convention or file type, it can 
work on files never created or used under 
OS/2 before. For example, in the sample 
case described for this article, PKUNZIP2 
can be used to unzip a floppy disk file 
from DOS which possesses no Extended 
Attributes. This is one of the greatest ben¬ 
efits of OS/2: that it can take a non-OS/2 
spreadsheet application, a word proces¬ 
sor or even a mimdane, time-worn utility 
such as PKUNZIP, and endow it with new 
features and capabilities it never before 
possessed. ♦ 


Don't forget — include your 
zip code, when notifying us 
of your change of address. 
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THE ULTIMATE OS/2 GAME 


THE BODY ELECTRIC 


Timur 

Tabi 


Timur Tabi can be reached 
at 11811 Federalist Way #2, 
Fairfax, VA 22030 or on the 
OS/2 Shareware BBS 
(Fidonet address 1:109/347). 


T hose pink checkerboards just had to go. 
Representing different building types by 
colored patterns is not my idea of an intu¬ 
itive user interface, so this month I introduce 
bitmaps to enhance the combat map. 

To facilitate bitmap programming, a new 
BITMAP module has been added. All bitmaps 
are loaded from the executable’s resources and 
stored in a memory presentation space. From 
there, they are displayed with a GpiBitBlt( ) call. 

The game now allows you to move a ‘Mech 
across the playing field. The ‘Mech starts out at 
location (0,0) and can be moved one hex at a 
time. Simply click on a nearby hexagon, and 
the ‘Mech will either turn to face it or move 
onto it. In BattleTech, each sixty-degree turn is 
one movement point, and a ‘Mech can only 
move forward or backward. The current ver¬ 
sion of this game does not keep track of move¬ 
ment points or turns, however. 

During targetting, the source hexagon is al¬ 



ways taken to be the ‘Mech, so once you click 
with the left mouse button, the targetting line 
is automatically drawn to the mouse pointer. 

BITMAP 

This new module provides generic bitmap sup¬ 
port for the entire game. All bitmaps are stored 
in the same memory presentation space. 

BitmapLoad( ) loads a bitmap and returns a 
bitmap handle if it succeeds. It also initializes 
the module when first called. Note all the 
WinMessageBox( ) calls to indicate an error. A 
more advanced error handler will be included 
in a future version. 

BitmapDraw( ) draws a bitmap on the client 
window. Most bitmaps in this game are irregu¬ 
lar in shape. The bitmap itself is always rectan¬ 
gular, but the image it holds usually is not. For 
instance, a bitmap of a terrain is hexagonal. 
The four corners are part of the bitmap, but 
not part of the image. 

Thus there is a problem. Some bitmap pixels 
must be drawn over the screen, and others 
should not overwrite anything. In other words, 
only a portion of the rectangular bitmap 
should be drawn. The rest should be ignored. 

By using a bitmap mask, this effect can be 
achieved. The mask is the same size and shape 
as the original bitmap and is drawn at the same 
location, but it contains only two colors: white 
and black. The black portions are where the 
true image exists in the original bitmap. The 
white areas are where the background image 
should show through. It is important to re¬ 
member that wherever the mask is white, the 
original bitmap should be black. 

The mask is logically ANDed with the 
screen. The black portions of the mask erase 
the screen, and the white portions leave the 
screen unaltered. Then the original bitmap is 
logically ORed onto the screen over the mask. 

If the mask bitmap handle is NULLHANDLE, 
then no masking operation is performed. This 
is handy for times when the background is al¬ 
ready known to be black. 

GAME 

Most of the window-related variables have 
been moved to a new module, WINDOW. How¬ 
ever, all of the code is tentatively still here. See 
the discussion of WINDOW for details. 

The window procedure has been updated 
only to reflect changes in the other modules. 
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For instance, WM_CREATE now calls 
Mechlnit( ) to initialize the MECH module. 

HEXES 

The biggest change in this module is the 
technique used to draw the combat map. 
The addition of bitmap support necessi¬ 
tated an update of the drawing functions. 
Also, the routines which support the dif¬ 
ferent terrains have been moved to a sep¬ 
arate module, TERRAIN. 

The following two methods were previ¬ 
ously used to draw the combat map: 

1. The client window is painted black. 
For each hexagon, the current color and 
pattern is set, and an area bracket is start¬ 
ed. A hexagon is drawn, the bracket is 
closed, and OS/2 fills in the rest. 

2. Similar to the first method, except 
that the client window is painted with the 
color and pattern of the default terrain (in 
this case, clear ground). A black hexagonal 
grid is overlaid. Only the hexagons which 
differ from the default are then painted. 

Beginning this month, a third tech¬ 
nique comes into play: 

3. The client window is once again 
painted black, the color of the hexagonal 
grid. The inside of each hexagon is paint¬ 
ed without redrawing the hexagon itself. 

The window procedure should take no 
longer than 1/1 Oth of a second to process 
any message, otherwise it blocks the mes¬ 
sage queue for too long. Unfortunately, 
drawing the entire combat map can take 
several seconds. 

One solution is to move HexDraw- 
Map( ) into a separate thread. This may 
solve the queue problem, but the combat 
map still takes too long to draw. Method 
#2 works well as long as the combat field 
is mostly of clear ground, which is not al¬ 
ways the case. 

The proper technique would be to use 
WinQueryWindowRect( ) to determine 
the hexagons which need to be redrawn. 
This function returns a rectangle that out¬ 
lines the region of the client window 
which has been invalidated. A function 
similar to HexLocate( ) could be used to 
find the four hexagons that lie on the cor¬ 
ners of that rectangle. Then Hex- 
DrawMap( ) would read: 

for (hi.c=iStartC; hi.c 

for (hi.r-iStartR; hi.r<=iEndR; hi.r++) 
HexFillDraw(hi); 


The individual hexagons, however, still 
take a long time to draw. There are a few 
potential solutions to this problem. Look 
for these and other speed enhancements 
in future articles: 

1. Draw all hexagons of a given terrain 
at once, thereby avoiding multiple calls to 
GpiSetColor( ) and GpiSetPattern( ). 

2. Use a different technique for draw¬ 
ing filled polygons. I have not explored all 
the possibilities yet, so there may be oth¬ 
er Gpi functions which work better. 

3. Use bitmaps for all the terrains. The 
GpiBitBlt( ) function might be faster than 
area-bracket fills. 

Two new defines, XLAG and YLAG, rep¬ 
resent the horizontal and vertical spacing 
between the hexagons on the hex map. 
The default value of two produces a 
spacing of one pixel. 

These defines only affect HexCoord( ), 
HexMidpoint( ), and HexLocate( ), since 
these are the only functions which main¬ 
tain a link between screen coordinates 
and hexindices. WINDOW. WIDTH and 
WINDOW.HEIGHT also use XLAG and 
YLAG to determine the size of the client 
window needed to display the entire hex 
map. 

MECH 

This month introduces a user-controlled 
‘Mech, supported by the MECH module. 
This module initializes the Mechs posi¬ 
tion and orientation in Mechlnit( ) and 
changes them in MechMove( ). Mech- 
Init( ) also loads the bitmaps representing 
the ‘Mech in all six orientations. 

MechMove( ) has to determine 
whether the Mech needs to be rotated or 
moved. First, it rejects any target hexagon 
which is not adjacent to the ‘Mech. Then, 
it calculates the direction to that hexa¬ 
gon. If this value is different from the cur¬ 
rent orientation, the Mech is rotated and 
redrawn. Otherwise, it is moved to the 
new position. 

If you wish to move the ‘Mech to a 
hexagon on its left or right side, click 
on the target hex once to rotate the ‘Mech 
and again to move him. However, do not 
click the mouse twice too quickly. This 
action is registered as a double-click, 
which means that OS/2 does not send two 
WM.BUTTON 1 DOWN messages. Rather, 
it sends one WM.BUTTON1DOWN 
followed by a WM.BUTTON 1DBLCLK. 


MENU 

Changes in the header file for this module 
eliminate the need for Menulnit( ), since 
this function did nothing but initialize 
global variables. A separate if-statement in 
MainCommand( ) allows this function to 
handle any number of terrains without a 
code change. The only other change to 
this module is the inclusion of my address 
in the “About...” dialog box. 

TERRAIN 

This module encapsulates all the terrain- 
related code and data which were once in 
HEXES. There are eleven terrain types, 
and each one has a set of attributes listed 
in structure TERRAIN. Function Terrain- 
Init( ) initializes the array of terrain data, 
ater[], with pre-defined constants. A con¬ 
figuration file will eventually be created 
to store information on all the terrains. 

Function TerrainIdFromMenu( ) returns 
the terrain ID (a number from 0 to 10) 
which maps to a given IDM_TER_xxx val¬ 
ue. In previous versions of this game, the 
terrain ID was the same as the menu ID 
listed in file RESOURCE. H. 

WINDOW 

This module does not contain any code 
yet, but its purpose is to localize most of 
the Presentation Manager specific fea¬ 
tures of this game. In the distant future, 
there might be interest in porting this 
game to other platforms. Separating the 
operating system specific code early on 
will make cross-platform development 
much easier. 

NEXT MONTH 

There are a few quirks and minor bugs in 
this code which have yet to be fixed. The 
mouse is never captured during target¬ 
ting. Clicking on the client window will 
not bring it into focus. The info box is not 
hidden when the main window is mini¬ 
mized. These and other problems will be 
addressed in the next installment. 

I would also like to make a formal re¬ 
quest for volunteer translators. As you 
know, multilingual support is one of the 
goals of this project. I expect to have a 
few dozen single-line strings (most of 
them error messages) which need to be 
translated into as many foriegn languages 
as possible. Anyone out there interested 
in lending a hand? ♦ 
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GETTING THE MOST OUT OF OS/2 


SHAREWARE 


Lou 

Miranda 


C onventional wisdom says that a new operat¬ 
ing system is made or broken by the pres¬ 
ence of a “killer application”. What really 
happens, though, is that it’s the shareware appli¬ 
cations and games that make or break an OS. Un¬ 
fortunately, shareware (and games!) for OS/2 have 
been slow in coming. That’s not unexpected, con¬ 
sidering that developers’ kits originally went for 
$2700 — how many shareware authors would 
splurge for that? 

The Times, They Are A-Changin' 

Luckily, two important events appear to be chang¬ 
ing all that. IBM has suddenly realized the impor¬ 
tance of smaller developers — from shareware au¬ 
thors to students to freelancers — and at the time 
of this writing has just offered an OS/2 2.01 beta 
CD-ROM developer’s kit for $15. That’s right: fif¬ 
teen dollars . It includes not only IBM’s C compil¬ 
er, but a beta of the next version of OS/2, includ¬ 
ing Windows (dare I mention that word?) 3.1 
support for WinOS2. This smart marketing move 
on IBM’s part may just turn out to be a key factor 
in the long term acceptance of OS/2. 

The other bright spark on the horizon is the im¬ 
minent release of Borland’s OS/2 C++ compiler 
(which may be out by the time you read this). 
Since many programmers have jumped on the 
C++ bandwagon for code reusability and 
code+data encapsulation, I imagine that a straight 
C compiler just isn’t good enough any more. And 
since Borland appears to be the trend-setting com¬ 
pany for C++ (and Microsoft has completely and 
utterly abandoned OS/2), this is a product that 
many developers have been waiting for. If Borland 
ports the ObjectWindows Library (OWL) ap¬ 
plication framework to OS/2, that should 
make the transition even easier, if not entirely 
painless. 

What's Out There? 

I recently went out on a downloading binge. 
What’s out there, in terms of shareware, freeware, 
and public domain software? My first voyage was 
to CompuServe’s OS/2 forums, to see what pro¬ 
grams were there. But before continuing, let’s de¬ 
fine some terms: 

Shareware is not free software. Shareware is 
not cheap software. Shareware is simply “try be¬ 
fore you buy” software. That’s it. A simple market¬ 
ing method. It is copyrighted, just like commercial 
software, but the authors trust you to try it and 


see if you like it before spending your hard earned 
cash. It’s that simple. 

Freeware or hannerware is also copyrighted, 
but is offered to people free of charge. It’s often a 
disguised advertisement — but, hey, it’s free! 

The authors of software in the public domain 
have given up their rights to the program. It is not 
copyrighted (or copyright has expired) and may 
be freely redistributed. 

Now, after downloading quite a few programs, I 
came across two gems. One is shareware and the 
other is bannerware. First, the shareware. 

Screen Capture With Nikon II 

One of the first programs I looked at turned out to 
be one of the best. It’s called Nikon II, and it’s a 
screen capture utility. All of the pictures in this ar¬ 
ticle were produced with this software. 

I was so excited about this program that I tried 
it without looking at the documentation. Of 
course, it specifically warns you to read the docu¬ 
mentation first, but I thought, “It’s a screen cap¬ 
ture utility — how difficult can this be?” I was 
wrong. 

Not that installation is difficult, mind you. You 
just have to make sure it gets minimized to the 
desktop instead of the Minimized Window Folder. 
Once you have that set up, it’s a breeze. 

Nikon II can capture the entire desktop, an en¬ 
tire window, or the “client” area of a window (i.e., 
everything except the border, title and menu). Or, 
you can click and drag over any part of the screen. 
There’s an Options dialog box that lets you specify 
what it is you want to capture. Any of these can be 
set up as the default, or, more conveniently, you 
can have the program pop-up a dialog box before 
it captures anything. That way, you can select 
what it is you want to capture without having to 
reconfigure the program each time you use it. 
Very convenient feature. 

It’s output options are powerful, too. You have 
the choice of sending it to the printer, the clip¬ 
board, or a file. Files can be in any of several dif¬ 
ferent formats, including BMP, TIF, IMG and PCX. 
That way, you can import the file into your fa¬ 
vorite bitmap editing program and edit it to your 
heart’s content. Or load it into a word processor 
or spreadsheet for added impact. The file formats 
it supports are supported by virtually every pro¬ 
gram. Very comprehensive. 

Nikon II gives you the option of having the ar¬ 
row cursor included in the screen capture or leav- 
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ing it out. It also adds a few menu items 
to the default menu when you click on its 
minimized icon with the right mouse but¬ 
ton. The Options dialog box can be 
brought up this way, for example. 

So it basically gives you all you could 
ever want from a screen capture utility. 
Well, it doesn’t have any editing capabili¬ 
ties, but you can buy a bitmap editor for 
that. All in all, it’s a well thought out, easy 
to use program that does virtually every¬ 
thing that you could want. A great bargain. 

Program: Nikon II. 

Price: US$50 (approximately; you pay 
in Australian dollars) 

Where to get it: 

Executive summary: An easy to use, con¬ 
figurable screen capture utility that can use 
the clipboard, your printer, or a number of 
file formats for output. A great deal. 

Around the World in 80 seconds 

Another gem lurking on CompuServe is 
actually bannerware. Or, in the lingo of 
IBM, it’s “OS2EWS ” It took me a long 
time to figure that one out, but it means 
“OS/2 Employee Written Software.” This 
awesome program, PM-Globe, was writ¬ 
ten by an IBM employee. 

PM-Globe is not going to reduce the na¬ 
tional debt; it won’t make you more com¬ 
petitive; it won’t let you move up the 
ranks at your job any quicker. But it is a 
very cool program, and it will make you 
the envy of your friends! 

Why is that? Because it’s a very slick 
graphical program, that’s why. PM-Globe 
displays a picture of the earth on your 
screen. “Ho-hum,” you say. “I already have 
bitmaps of the earth. Big deal.” But wait 
— this one is dynamic. Rather than pre¬ 
senting a static picture of the earth, it 
shows the sun and the shadow of the 
globe. In its “3-D” mode, it even approxi¬ 
mates a three-dimensional look. 

And there’s more! PM-Globe actually re¬ 
draws its window (at user-defined inter¬ 
vals) so you can see the changing pattern 
of illumination on the earth (see figures) 
in real time. If it’s six o’clock where you 
are, it’ll show your position on the map at 
the border where light meets dark. If it’s 
noon, PM-Globe will show your area of 
the earth in full sunlight. And if you leave 
it on your desktop all day, the view will 
change dynamically to reflect the time of 
day. Wow. This is neat stuff. 

There are many other options. You can 


calculate the distance between any two 
points on the earth. It will display any 
point on earth as the center of the screen 
(just point and click; no need to enter co¬ 
ordinates). It will display land and oceans 
in any color you want. It even has a 
macro language! Enter macro commands 
and PM-Globe will locate cities on the 
map, and the current time (which, again, 
will change dynamically). 

This is an outstanding program. I 
would readily pay $25 for something like 
this. But you can get it free. Just don’t let 
your boss catch you using it. Unless you 
tell him that you’re working on interna¬ 
tional sales, maybe. 

Program: PM-Globe version 1.0 (?) 

Price: Free 

Executive Summary: A great piece of 
free software that’ll impress the heck out 
of anyone. 

That’s it for shareware this month. If 
you’ve found any gems lately, or you’ve 
written a masterpiece yourself, drop me a 
line in care of OS/2 Monthly. I’ll look into 
it. Or, if you’ve found a good source of 
OS/2 shareware, let me know. ♦ 


ANNOUNCING 

REXXpress 

The Newest Cross 
platform Rexx 
Bi-Monthly 
Newsletter 

Call 908-937-6542 
for Info 
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/ XModem, XModem-1 K, YModem, YModem-G, ZModem, CIS, m B-Plus 
/ ANSI Terminal, VT100, IBM3101, Standard TTY 
// Low $65.00 Price // Free technical support! 


For information call: 

Oberon Software 1-507-388-7001 

518 Blue Earth St. Credit card orders call PSL at: 

Mankato, MN 56001 1 -800-242-4775 
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MANAGEMENT VISIONS 


WHEN COMPUTERS ARE NOT ENOUGH 


Tim 

Bryce 


Tim Bryce is with the 
Tampa Bay management 
consulting firm of M. Bryce 
& Associates, Inc. (MBA). 
Copyright (C) MBA 1993 


T his is the first in a series of columns aimed 
at the management aspects of information 
systems. Other columns convey important 
technical information on hardware and software 
related matters, but this one will be different. 
This is intended for the manager who has busi¬ 
ness problems to solve, deadlines to meet, and 
people to lead into battle. One more column 
aimed at the technological marvels of the com¬ 
puter will not necessarily help. But perhaps 
some practical advice on management will. 

Productivity will be one of the recurring 
themes in this column. This is what every man¬ 
ager seeks to maximize. In today s world of 
high-tech computing, productivity has come to 
be regarded as synonymous with efficiency. This 
is totally fallacious. There is more to productivi¬ 
ty than how fast a task can be performed. A lot 
depends on whether the task is even warranted. 
After all, an elegant solution to the wrong prob¬ 
lem solves nothing. 

PRODUCTIVITY = EFFECTIVENESS x EFFICIENCY 

The one variable frequently overlooked in 
terms of productivity is “effectiveness.” Whereas 
efficiency is concerned with how well a task is 
performed, effectiveness questions the necessi¬ 
ty of the task. Stated another way: “Are we do¬ 
ing the right things?” (effectiveness) and “Are 
we doing things right?” (efficiency). 

Comedian Bob Newhart illustrated the differ¬ 
ence between efficiency and effectiveness when 
he recorded his “1,000 Monkey” skit several 
years ago. In the sketch, Bob wondered what 
would happen if you locked 1,000 monkeys in a 
room with typewriters. His premise was that in¬ 
stead of using experienced writers, perhaps you 
could produce the same results with less expen¬ 
sive labor using the latest tools. He figured that 
if the monkeys were allowed to play with the 
typewriters long enough one of them might be 
able to write something worthwhile. And his ex¬ 
periment almost worked. One of the monkeys 
wrote, “To be or not to be, that is the gizornen- 
flat . . .” 

Bob’s idea may be comical, but what is unset¬ 
tling is that this has become the predominant 
method for developing systems in this country. 
Instead of having business analysts and systems 
engineers specifying and designing our informa¬ 
tion systems, we have bred a generation of ap¬ 
plication developers proficient in the latest pro¬ 


gramming languages and software design tech¬ 
niques and armed with CASE tools. They may 
know how to program, but they haven’t the 
slightest idea how to design and build an infor¬ 
mation system in its entirety. Consequently, we 
have become efficient at writing software but 
ineffective in building enterprise-wide systems. 

Fortunately, a backlash appears to be in the 
offing. Today, the latest catch phrase is “Busi¬ 
ness Process Re-Engineering” (BPR). This is 
where whole departments and systems are be¬ 
ing re-evaluated and re-designed. Regardless of 
the media hype surrounding BPR, it actually rep¬ 
resents a throw-back to the years before com¬ 
puters, when companies maintained “Methods 
and Procedures” departments to organize and 
streamline office systems. With the advent of 
the computer, these departments were sup¬ 
planted by today’s data processing organiza¬ 
tions. Regrettably, these vital systems skills were 
lost in the process and are only now beginning 
to re-surface in BPR. 

The objective of “Business Process Re-Engi¬ 
neering” is to define the mission and organiza¬ 
tion of the business; to define the information 
needed to support the actions and decisions of 
the business; to define “effective” business 
processes in support of information require¬ 
ments; and to determine the most “efficient” 
way to implement the business processes (e.g., 
computer hardware/software, office automation 
or manual processing). 

Companies have discovered that BPR is an im¬ 
portant part of improving effectiveness, from 
both a development and an operational view¬ 
point. Instead of programming without an over¬ 
all system architecture (a la the “ 1,000 Monkey” 
approach), programmers work in a concerted 
effort. Further, manual tasks are not simply re¬ 
placed by computer automation. Instead, the 
whole business process is challenged and 
man/machine interfaces are re-defined. Conse¬ 
quently, the “right” computer hardware/soft¬ 
ware is used to solve the “right” business prob¬ 
lems. This, coupled with efficient software 
engineering, results in improved productivity. 
This month’s lesson, therefore, is simple: 

“There is nothing more unproductive than to 
build something efficiently that should never 
have been built at all.” 

— BRYCE’S LAW 
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OS/2 PRESENTATION MANAGER PROGRAMMING 


Les 

Bell 


Les Bell is a consultant, 
author and lecturer based 
in Sydney, Australia, 
who specializes in 
OS/2 development 
and training. 
His CIS ID is 71210,104. 


Les Bell resumes his series on introductory 
OS/2 Presentation Manager programming. 

Beginning Presentation Manager program¬ 
mers often wonder about the terminology and 
style of PM programs. Why, for example, does 
a program have to register a window class be¬ 
fore creating a standard window? You often 
read comments about creating a window using 
the windows registered class — what does 
that mean? And does this relate to the use of 
classes in object-oriented programming? 

It’s possible to create quite complex pro¬ 
grams in PM without dealing with these prob¬ 
lems directly. However, sooner or later, they 
have to be confronted. And that’s what this ar¬ 
ticle is about. 

As you run multiple applications under PM, 
you’ll notice that certain window components 
appear all over your screen. There are multiple 
title bars, for example, and minimize/maxi¬ 
mize icons, menu bars and system menu icons. 
At any one time, a dialog window might dis¬ 
play multiple text entry fields, multiple list 
boxes and multiple push buttons. 

Think about this for a moment. As you may 
know, the different window components and 
controls in OS/2 are in fact windows in their 
own right (unlike in Windows!). That means 
that they must have their own winprocs, right? 

Now, take a look at some of your own win¬ 
procs. Or, take a look at some of the examples 
in the Petzold book. Notice anything about the 
variables used in the winproc code? A lot of 
them are static, which means that the winproc 
is not re-entrant — it can only be used by a sin¬ 
gle window. For example, suppose the win¬ 
dow color was stored in a static variable in the 
winproc (as it is in some of Petzold’s code). 
Then, if two windows of the same type were 
created, they would both have the same color, 
and if the color was changed for one, it would 
also be changed for the other — which might 
or might not be the intended effect. Much 
worse effects are likely — they’re called bugs. 

Clearly, the various title bars currently on 
your screen have different coordinates, sizes, 
colors, text and so on. Those attributes cannot 
be stored in static variables in the winproc, so 
where are they? The answer lies in window 
words, also known as instance data. 

The WinRegisterClass( ) function call takes 
five parameters: the anchor block handle; a 


pointer to the window class name; a pointer to 
the winproc; a class style; and the number of 
bytes of storage reserved in each window of 
this class. It is this last parameter that is of the 
most interest to us. 

Once the window class has been registered, 
whenever a program calls WinCreateStdWin- 
dow( ) to create a new window of this class, 
the system creates the appropriate data struc¬ 
ture internally to represent this window. Just 
what is in this structure is private to the sys¬ 
tem, and writing applications which depend 
upon a knowledge of the structure is asking 
for trouble in the form of future portability 
problems. However, an application is able to 
access any of the following fields: 

pointer to window-class data structure; 

WinQueryClassName( ); WinQueryClassInfo( ); 

pointer to window procedure; 

WinQueryWindowPtr(hwnd,QWP_PFNWP); 

parent-window handle; 

WinQueryWindow(hwnd,QW_PARENT,flock); 

owner-window handle; 

WinQueryWindow(hwnd,QW_OWNER, flock); 

owner of this window’s frame; 

WinQueryWindow(hwnd,QW_FRAMEOWNER,flock)? 

handle of the topmost child window; 

WinQueryWindow(hwnd,QW_TOP,flock); 

handle of the bottom child window; 

WinQueryWindow(hwnd,QW_BOTTOM,flock); 

handle of the next sibling window; 

WinQueryWindow(hwnd,QW_NEXTTOP,flock); 

handle of the previous sibling window; 

WinQueryWindow(hwnd,QW_PREVTOP,flock); 

handle of the window below in z order; 

WinQueryWindow(hwnd,QW_NEXT,flock); 

handle of the window above in z order; 

WinQueryWindow(hwnd,QW_PREV,flock); 

window size and position (as _SWP 

structure); 

WinQueryWindowPos( ); 
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Develop GUI applications in COBOL 
without learning "C". 


OS/2 Presentation 
Manager 
Programming 
for COBOL 
Programmers 

Robert B. Chapman 


OS/2 Presentation Manager 
Programming for twa 
COBOL Programmers rE3 

Robert B. Chapman 



440 pages • Paperback with Diskette • ISBN 0-89435-439-6 • $39.95 


The first book in QED’s OS/2 series teaches business 
application developers the techniques and basic skills 
necessary to create applications using IBM’s OS/2 
Presentation Manager. A major benefit of the book is 
to teach COBOL programmers to develop GUI appli¬ 
cations without learning “C”. 

This book covers all aspects of PM from a simple 
display-only window application to a multiple-win¬ 
dow, DLL-supported, SQL-based, fully functioning 
business application. Topics include an introduction 
to current concepts and realities associated with pro¬ 
gramming in the OS/2 PM environment, an introduc¬ 
tion to OS/2 PM, basic PM function calls necessary to 
initiate a PM application, and development and 
enhancement of a PM application. 


Chapman includes a disk of object code, exe¬ 
cutable code, SQL, transaction input and output files, 
resource and icon files—everything covered in the 
book. 

CONTENTS: Introduction. Presentation Manager. 
Create PM Environment and a Window. Display 
Information in a Window. Displaying Real 
Information. Menu Bar, Dialog Box, Icon, and 
Accelerator Table. Multi-line Entry, Listbox, Combo 
Box, Radio Buttons, Check Boxes. Modeless Dialog 
Boxes. Multiple Windows. Help Processing via IPF. 
Printing a PM Report. Introducing SQL I/O. Dynamic 
Link Libraries. Sample Programs Compile and 
Execute Environment. PM Subroutine Calls (The PM 
API). PM Messages, Styles, Styles, Classes, and Codes. 
Glossary. Index. 
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window size and position (as _RECTL structure); 

WinQueryWindowRect; 

lock count; 

WinQueryLockCount( ); 

window style; 

WinQueryWindowULong(hwnd,QWL_STYLE); 

update-region handle 

WinQueryUpdateRect( ); WinQueryUpdateRegion( ); 

The flock parameter is required in OS/2 1.x (where it is ig¬ 
nored in 1.2 and later), but is not required in OS/2 2.x. 

When a nonzero value is specified for that last parameter 
to WinRegisterClass( ), subsequent calls to WinCreateWindow 
or WinCreateStdWindow will not only create the usual window 
structure, but will also append the specified number of bytes 
to the end of the structure, for use by the application program¬ 
mer. Notice that this data structure is created for each 
window. 

Setting and Querying Values 

The programmer can now use these bytes — which are re¬ 
ferred to as window words — to store values that are associat¬ 
ed with that particular window in the window structure. The 


winproc relates to a class, while the window structure relates 
to an object. Speaking informally, we’d say that we are storing 
values in the window. 

The window words can be used to store 16-bit USHORT val¬ 
ues, 32-bit ULONGs or a 32-bit far pointer, with the following 
functions: 

BOOL WinSetWindowUShort(HWND, SHORT index, USHORT us); 

BOOL WinSetWindowULong(HWND, SHORT index, ULONG ul>; 

BOOL WinSetWindowPtr(HWND, SHORT index, PVOID p) ; 

In each case, the index is the zero-based byte offset of the de¬ 
sired data item. For example, if there are three pointers stored 
in the window words, then the offset of the third pointer 
would be eight. Values can be retrieved with the following 
functions: 

USHORT WinQueryWindowUShort(HWND hwnd, SHORT index); 

ULONG WinQueryWindowULong(HWND hwnd, SHORT index); 

PVOID WinQueryWindowPtr(HWND hwnd, SHORT index); 

Now we have a way of storing values which are specific to a 
window, rather than the class. The most common technique 
used is to create a data structure which corresponds to the win¬ 
dow, and then to store a pointer to that structure in the win¬ 
dow words. 


Softbridge 


Worried about testing your OS/2, networked applications? 
Not if you're using the Softbridge Automated Test Facility. 


If you’re building OS/2 (or Windows) 
applications, you know that software 
testing is half the battle in the development 
cycle. If your applications are networked, 
they're even more complicated to test. 

The Softbridge Automated Test Facility 
(ATF) was designed for unattended, 
centralized testing of OS/2 and Windows 
applications, networked or stand-alone. 

ATF is used by corporations and software 
vendors who want to: 

S Build higher quality software 
S Decrease development time & costs 
S Make the impossible possible 


Don't just take our word for it ... 

Cooperative Solutions used ATF to test 
Ellipse, and "Ellipse has been practically 
bug free." (Datamation - March 15, 1992) 

"Reuters Information Service has used 
ATF for three months to test a client/server 
application. So far, ATF has enabled the 
firm to reduce the time required to perform 
800 test cases from one month to one week." 
(Network World - June 22, 1992) 

"Bachman Information Systems chose ATF 
because it's 70-80% better than anything on 
the market.” (PC Week - June 15, 1992) 


If software quality is on your checklist call 800-955-9190 and learn more about ATF. 


Softbridge, Inc. 125 CambridgePark Drive Cambridge, MA 02140 617-576-2257 
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Only a few years ago, alliances 
among major computer companies were 
rare. But in today’s global marketplace, 
even rivals collaborate to build their 
businesses and meet customer demand. 
In building this network of alliances, 
original equipment manufacturers 
(OEMs) have become very important 
because some of these alliances started 
as OEM relationships. 

Historically, an OEM was narrowly 
defined in manufacturing as a provider 
of hardware to other companies for use 
in their products. These OEM buyers 
then added their unique value and mar¬ 
keted the enhanced products to their 
customers. For the computer industry 
today, an OEM relationship exists when 
a company provides hardware or soft¬ 
ware products—and often services—to 
other manufacturers, developers or inte¬ 
grators. To differentiate the provider of 
software, a new term is being used— 
original software developer, or OSD. 

OEM has taken on a new impor¬ 
tance and an expanded scope in the 
1990s. Recognizing that fact, the Indus¬ 
trial Sector Division’s Boca Raton 
Laboratory recently formed a team, 


headed by Ray Leon, to market the lab’s 
industrial hardware and software prod¬ 
ucts to OEMs and OSDs, respectively, 
inside and outside the industrial sector. 


The products that ISD is targeting 
at the OSD and OEM marketplace 
include a family of client/server enabling 
software, known as Distributed Applica¬ 
tion Environment (DAE), which provides 
application portability across a number 
of computer platforms, operating sys¬ 
tems and communication topologies 
(see Figure 1), and the Micro Channel 
interface chips. 

Overview of DAE 

A key software product for ISD, DAE 
is especially well-positioned for use by 
OSDs because it provides value “under 
the covers” in their products. OSD con¬ 
tracts for DAE have already been closed, 


including ones with Datatrend and GE 
Fanuc. Datatrend provides a combina¬ 
tion of software and service to migrate 
Series/1 applications to the RISC 
System/6000* GE Fanuc provides 
CIMPLICHY,** a cell control and manu¬ 
facturing execution application that 


helps IBM market to key U.S. automo¬ 
tive and other plant-floor accounts. 
Several other relationships—in the U.S. 
and worldwide—are in process. 

Distributed client/server computing, 
a prime objective for many organizations, 
usually involves heterogeneous systems 
networked together into a single system 
image for quickly and accurately collect¬ 
ing, processing and updating online 
information, such as inventory records, 
customer order data, and bank account 
statements. DAE helps customers to 
implement their client/server applica¬ 
tions faster and with lower development 
and maintenance costs. 

The DAE family of products already 
supports the OS/2, DOS, 
OS/400* and VM/ESA* oper¬ 
ating systems. In December, 
IBM delivered new DAE prod¬ 
ucts that will enable cus¬ 
tomers in industries such as 
banking and retailing, and the 
financial, industrial and pub¬ 
lic sectors to use IBM’s RISC 
System/6000 computer in a 
DAE distributed client/server 
network for their critical busi¬ 
ness applications. 

A single system image 

DAE enables applications 
in a distributed network of 
heterogeneous systems to 
have a single system view of 
other applications and 
resources in the network. 
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Figure 1. Distributed Application Environment architecture. 
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“ OEM has taken on a new importance and an 
expanded scope in the 1990s.” 












































Networks can be as simple as a single 
node or as complex as a distributed net¬ 
work of different vendors’ systems with 
different communication protocols. 

Communication protocol 
independence 

DAE supports IBM’s, other vendors’ 
and open multivendor network proto¬ 
cols. Network protocols and communi¬ 
cation mechanisms are transparent to 
the application and can be changed 
without application program changes. 

Application portability 

DAE applications are portable 
between DAE-supported environments. 
Today, that includes OS/2, AIX,* 
VM/ESA and OS/400 for server and 
client functions and DOS for client-only 
functions. Applications can be moved 
from one processor type to another to 
accommodate increasing or decreasing 
transaction volumes. 

Distributed applications 

DAE provides the enabling base for 
distributed data, presentation, comput¬ 
ing, and system management services. 
Applications or requesters are loosely 
coupled to their servers, which may be 
on the same node or on a remote node 
in the network. Physical location of 
requesters and servers is transparent to 
the user. 

Distributed presentation services 

DAE provides a client/server rela¬ 
tionship between the user interface and 
the application program enabling a pro¬ 
gram on one node to display its screens 
on other remote nodes. For example, 
an ADC-based application can display 
its screens (and appear to be running) 
on other OS/2-based nodes using 
Presentation Manager* (PM) or on other 
ADC-based nodes using X Windows** and 
Motif.** The user interface server directs 
the screens to the proper node and even 
uses the same panels for the dissimilar 
nodes by reconciling the differences 
between PM and X Windows and Motif. 

Distributed management 

DAE provides NetView* application 
alerts, network distribution, controlled 
network startup/shutdown, global 
trace, security, configuration and more. 

Modular network 

Resources can be moved, renamed, 
rehosted, or renetworked without 


changes to application programs. 
Resources include programs, printers, 
tables, databases, communication links 
and devices. Networks can be optimized 
for changing business conditions with¬ 
out reprogramming. 

Distributed device connectivity 

DAE’s device management services 
provide a logical “universal device 
controller” view for a wide range of 
controllers, devices and equipment, for 
example, programmable logic controllers 
(PLCs), distributed control systems 
(DCSs), Manufacturing Message System 
(MMS) devices, numerical controllers, 
robotic systems, sensors, data collection 
terminals, bar code readers, magnetic 
stripe readers and credit card readers. 

These distributed and uniform 
services, which provide concurrent, 
simultaneous and prioritized equipment 
access, include, for example, querying 
and changing device status; download¬ 
ing/uploading device programs; access¬ 
ing data transformed to the format 
required by the program monitoring for 
events or conditions; and controlling 
access to device resources. 

Connection to transaction processing 
systems 

Via DAE Host Link, DAE applica¬ 
tions can connect to transaction 
processing systems such as IMS/MVS, 
CICS/MVS and CICS/VM transaction 
processing systems. The interface used 
to communicate with the transaction 
processing applications is the same as 
the local communication interface so 
that location transparency is preserved, 
and a single system image is perceived. 

Enabler for IBM applications 

DAE provides an open architecture 
and communication services for 
manufacturing applications such as 
PlantWorks, Paperless Manufacturing 
Workplace and Process Operations 
Management System (POMS). The AIX 
Software Development Environment 
(SDE) Workbench/6000 development 
tools and services enable users to create 
a customized, integrated software devel¬ 
opment environment that can be applied 
to DAE application programming. 

Open extensions 

DAE provides an application pro¬ 
gram interface (API) into its lower-level 
functions and services. This API can be 


used to seamlessly “snap-on” unique 
non-DAE protocols or services to the 
DAE environment. Users can develop 
the “snap-ons” or obtain them from 
system integrators and IBM via services 
offerings. 

DAE and the open enterprise 

DAE is committed to the open enter¬ 
prise and to the orderly implementation 
of key technologies such as the Open 
Software Foundation (OSF**) Distrib¬ 
uted Computing Environment (DCE**). 

Enabler services 

A wide range of distributed appli¬ 
cation services includes APPC, APPN, 
TCP/IP, NetBIOS, DECnet** and 
Novell’s IPX/SPX** communications for 
a variety of local area network (LAN) and 
wide area network (WAN) configurations, 
including Ethernet, Token-Ring Net¬ 
work, SDLC, Fiber Distributed Data 
Interface, X.25, Manufacturing Message 
Specification (MMS), and the ISO 
8802.X family of LAN standards. 

Distributed data management 
services include data location and repli¬ 
cation transparency; distributed trans¬ 
action management; relational database 
services based on ANSI Structured 
Query Language (ANSI SQL) from IBM, 
Oracle and other vendors supporting 
the ANSI SQL standard and IBM 
Distributed Relational Database Archi¬ 
tecture (DRDA); and access to the 
advanced operational repository and 
data management functions of the 
CDF/MVS. 

DAE’s future 

Today, DAE runs in AIX and 
VM/ESA 32-bit environments and 
supports both 16-bit and 32-bit DAE 
OS/2 2.0 applications. DAE will further 
exploit the OS/2 32-bit operating system 
while protecting existing OS/2-based 
applications. 

DAE platform functions will be 
extended in stages to incorporate ele¬ 
ments of the OSF. The first instance of 
this will be OSF DCE’s directory and 
security services. DAE will be extended 
to include support for MVS, which will 
be one component of a DAE-based com¬ 
munication infrastructure for an enter¬ 
prisewide CDF/MVS repository. 

DAE can also be made available in 
non-IBM Unix** and non-Unix hard¬ 
ware/software environments and as a 
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Microsoft** Windows** application—all 
via service offerings with mutually 
agreeable terms and conditions. 

The longer-term strategy for DAE 
includes support of Open Systems 
Interconnection (OSI) as it becomes 
available as an IBM-supported prod¬ 
uct/protocol. Existing DAE applications 
will not need to be changed to use OSI. 
DAE will support Distributed Manage¬ 
ment Environment (DME**) and other 
elements of the Open Software Founda¬ 
tion as they evolve. 

DAE is a proven technology in 
retail, transportation, aeronautics, 
pharmaceuticals and in other applica¬ 
tions requiring distributed client/server 
communication, portability, data and 
device management across heteroge¬ 
neous platforms, and a single system 
image. DAE is the strategic client/server 
and messaging system enabler for IBM’s 
Computer Integrated Manufacturing 
(CIM) architecture and as such also 
includes device management services 
and APIs commonly required by CIM 
applications. 


streaming on the Micro Channel for 
large burst transfers. 

Two independent, full-function bus 
master channels provide the bus master 
compatibility. The chip is also easily 
attachable to the Micro Channel 
requiring only one transceiver for 
control signals. 

ISD offers OEM customers the 
32-bit memory controller (Brighton), 
which interfaces a 25 MHz Intel** 
80960CA, a 32-bit local bus, and two 
dynamic random access memories 
(DRAMs). The memory interfaces can be 
accessed independently for concurrent 
operation of the 80960CA processor and 
the local bus. The chip also allows high¬ 
speed access from the processor to 
local-bus memory and from the local 
bus to processor memory, enabling full 
addressability of both memories from 
each bus. Memory protection support 
and error checking and correcting (ECC) 
ensure data integrity. 

ISD is also offering its 16-bit 
Micro Channel interface chip to OEM 


customers. The chip provides Micro 
Channel bus master and memory 
controller capabilities and acts as the 
interface for both an 80C186 processor 
and Micro Channel with up to 2MB 
resident memory. Its Micro Channel 
bus master capability is provided by a 
direct memory access (DMA) channel 
between the Micro Channel and resi¬ 
dent memory. 

As the first OSD software success 
for the Industrial Sector Division, 

DAE continues to be a key product 
for the OEM market. Similar success 
with the Micro Channel interface chip 
products, along with growing opportu¬ 
nities in the worldwide OEM market, 
shows the ISD Boca Raton Laboratory 
team that they are on the right track 
for 1993. ■ 

For more information Contact: 

Frank Monez, (407)443-0501 or 
Joe Aaron, (407)443-8047 

IBM Industrial Sector Division 
P.O. Box 1328, Mail Drop 4303 
Boca Raton, FL 33429-1328 


Micro Channel 
interface chips 

The successful OSD 
startup for the lab’s software 
products has been repeated 
with the OEM hardware 
products. 

ISD’s 32-bit Micro Chan¬ 
nel interface chip (Miami) 
provides high-speed access 
between the Micro Channel 
and a high-speed, 32-bit local 
bus (see Figure 2). The chip 
can stream data at 80MB 
streaming rates as both a 
Micro Channel bus master 
and slave. Internal buffering 
and a bursting local bus 
allow the chip to sustain 

• IBM, Micro Channel, PlantWorks, Paperless Manufac¬ 
turing Workplace. PS/2. OS/2. RISC System/6000. 
OS/400. VM/ESA, ADC. Presentation Manager, 
NetVlew. ES/9000. are trademarks or 
registered trademarks of International Business 
Machines Corp. 

•• CAD AM is a registered trademark of CAD AM, Inc. 

** CATIA is a registered trademark of Dassault Systems 
Company. 

” CIMPUCITY is a trademark of GE Fanuc. 

** X Windows. OSF, DCE and DME are trademarks of 
Open Software Foundation. 

•* Motif is a trademark of Massachusetts Institute of 
Technology. 

•• DECnet is a registered trademark of Digital Equip¬ 
ment Corp. 

** IPX/SPX is a trademark of Novell. Inc. 

** Unix is a registered trademark of Unix System 
Laboratories. Inc. 

** Microsoft and Windows are registered trademarks of 
Microsoft Corp. 

•• Intel. 1386 and i486 are registered trademarks of 
Intel Corp. 
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Figure 2. Functional block diagram of the Micro Channel interface chip. 
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Made For 
Each Other 

RAIDION -LT and OS/2 

A Perfect Match. Introducing RAIDION LT fault-tolerant disk 
arrays for IBM OS/2 or LAN Server based systems. RAIDION LT 
and RAIDWARE™ management software combine to create the 
first modular, RAID level 5 fault-tolerant storage subsystem 
designed specifically for use with OS/2. 

Reliability Plus. The LT offers the features you expect of a 
fault-tolerant storage subsystem, and then some. The Hot 
Swap of individual modules is fast and easy. An On-Line Spare 
option enables the subsystem to remain operating in a fault- 
tolerant mode even if one drive in the array fails. RAIDION LT 
is designed to give OS/2 users 100% data availability, 100% of 
the time. 



Easy to Install, Easy to Upgrade. Individual disk modules, 
with either 560 megabytes or 1.0 gigabytes of formatted 
storage, are combined to make a three-module array of either 
1.2 or 2.0 gigabytes. And increasing capacity is simple. Add one 
or more modules to a three-module stack to increase capac¬ 
ity. A total of 4 seven-module a stacks can be combined to 
provide up to 28 gigabytes^^H^ of fault-tolerant storage. 


TM 


For more product information or the name of your nearest authorized 
RAIDION distributor call 1-800-395-3748. 


MICROPOLIS* 

IBM and OS/2 are registered trademarks of IBM Corporation. 













Why Take Chances? 


Is your data backed-up, or do you just feel lucky? 


Easy to use PM Interface 

File selections are fast and easy. If you can 
open a Work Place Shell Drive or folder Icon, 
you already know how to navigate through 
the file selection process. Selecting files is as 
simple as point and click. 


HPFS and FAT file systems 

BackMaster supports both FAT( File Allocation 
Table ), and HPFS (High Performance File 
System ). Backs up Extended Attributes, files 
with Long File Names, Workplace Shell, and 
System files. 


Backup to Floppy or Tape! 

BackMaster supports backups to Floppy Disk, 
or a variety of QIC-40/80 floppy based tape 
drives including CMS Jumbo. 


Read your old DOS tapes! 



-Q' 


Locked Files Errors 


-a 
-a 

—Q 

-□ 
-a 


Retry Count 

999 t 

V Prompt 


Retry Count 
999 : 


Yes 

No 


• Prompt 
If Newer 


Backup 
Backup Device: 

Qic BO * 

Compression: 

none MAX 

GHf 


V Prompt 02:28.‘04 PM 12 23 1992 

Unattended 


hour minute 

M § L?l. i 

month day 


Accept 


. AM 
• PM 

year 


* 

mom °e“ onsl 

BioonM 


Cancel 

Delayed On 

Help 


3 Last access date Last access time Creation date Creation time Flac 



BackMaster 

The Only 32-Bit Backup for OS/2 2.X. 

Multi-Threaded! 


Because BackMaster uses a standard QIC 
format for tapes instead of a proprietary 
format, you can easily read QIC-40/80 DOS 
tapes. You can Migrate from DOS to OS/2 by 
simply backing up using your DOS software 
and restoring with BackMaster. 


Variety of Backup Options! 




ONLY $79.95 




Make Total, Partial, or Incremental backups in 
the background or unattended. 


Uses STAC Data Compression. 

Uses LZS Data Compression from STAC 
Electronics for performance and reliability. 
Compression ratios average 2:1. 


Free Demo on our BBS. 

Call our BBS for a free demo version, and see 
why BackMaster makes backing up OS/2 so 
easy, you will backup more often. 


MSR Development 


Rt 7 #6409 Nacogdoches TX, 7596 7 
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Boosts OS/2 To The Max 


CPU Monitor/Ywv™ gives a real¬ 
time boost to your OS/2 1.2,1.3 
and 2.x environment. With CPU 
Monitor/te, you can display real¬ 
time CPU performance and RAM 
utilization data for all processes 
and threads; detect and stop 
invisible, runaway and back¬ 
ground programs; suspend and 
resume threads and dynamically 
change thread priorities for any of 
your OS/2 Presentation Manager 
applications. You can tailor the 
displays exactly to your liking 
since CPU Monitor/to’s displays 


are fully configurable. And now, 
OS/2 2.x users can display RAM 
utilization data for all processes. 
Show allocated and in-use 
amounts, ratios and more. For a 
limited time, CPU Monitor/ 5 /^ is 
only $129.95. Start getting 
maximum performance out of 
OS/2. Order CPU Monitor/Yws 
today! 
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Lava Nova True Color 

• 16.8 million colors at 1024 x 768 resolution 

• 3 8514/A co-processors (one per color channel) 

• 3 Megabytes of super-fast VRAM (video RAM) 

• Optimized Lava drivers for Windows 3.0/3.1, 
OS/2 ver. 2.0, and AutoCAD release 12 

• Lifetime Replacement Warranty 
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Lava Computer MFG. Inc. 

28A Dansk Court, Rexdale, ON., Canada, M9W 5V8 Tel: (416) 674-5942 Fax: (416) 674-8262 
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calendar, reminder, and scheduling features, methods of using menus and buttons. 
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Relish 32-Rit for discerning individuals brings an intuitive edge to desktop time and 
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LESS BELL 


Parents and Children 

An earlier chapter showed a simple sample program which 
prints “Hello World!” in a single window. Let’s expand that ex¬ 
ample to include two child windows each of which contains a 
different message. 

The major structural novelty is that we will now need two 
winprocs: one for the main client window area, as before, plus 
a new one for the child windows. Notice that we need only one 
winproc for two child windows, even though they will contain 
two different messages. 

Other things to look for will include the amended WinRegis- 
terClass( ) function call for the child window class, with the last 
parameter being the number of bytes of window words to be 
reserved. 


MRESULT EXPENTRY HelloChildWndProc(HWND hwnd, OSHORT usmessage, MPARAM 
mpl, MPARAM mp2)/ 

Next, more handles for the various parent and child frame 
and client windows: 

/* We need handles for both the frame window and the client window */ 
HWND hwndParentFrame, hwndParentClient; 

HWND hwndCIFrame, hwndC2Frame, hwndCIClient, hwndC2Client; 

And for the strings to be displayed: 

char *pszParentString - *I'm a main window!"; 
char *pszClString = "I'm child number one!"; 
char *pszC2String = "I'm the second child!"; 


♦define INCL_WIN /* This includes the window manager function 
prototypes, */ 

/* constants, etc. */ 

♦include <os2.h> /* This is the main OS/2 definitions 
include file */ 

Now we declare the window procedures: a main winproc 
and a winproc for the children: 


An extra classname will be needed, so we declare a static 
char for it as well as the main classname: 

/* Multiple windows can be maintained by one wndproc, so it's a class, 
rather than an object. The class is registered by name with 
the system */ 

static char szClassName[] = "Hello"; 

static char szChildClassName[] = "HelloChild"; 


/* Prototype for the applications window procedure */ 

MRESULT EXPENTRY HelloWndProc(HW#D hwnd, USHORT usMessage, MPARAM mpl, 
MPARAM mp2); 


Our program starts off in exactly the same way as the single 
window version: 
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WINDOW WORDS 


void main(int argc, char **argv) 

{ 

HAB hab; /* Handle to an 'anchor block' */ 

HMQ hmq; /* Handle to the input message queue */ 

QMSG qmsg; /* Queue message structure to hold the incoming 

message */ 

ULONG ulFrameFlags; /* Frame creation flags */ 

/* First, register with PM to get services. This returns a handle to 
an anchor block */ 
hab = Winlnitialize (0); 

/* Next, create a message queue */ 
hmq = WinCreateMsgQueue(hab, 0); 

/* Now register a window class for the application parent window */ 
if(IWinRegisterClass(hab, 

(PCH)szClassName, 

(PFNWP)HelloWndProc, /* Pointer to winproc function */ 
CS_SYNCPAINT | CS_SIZEREDRAW, /* Flags to force redraw when 
re-sized, etc. */ 


sizeof(char *))) 


'window words' */ 

DosExit(EXIT_PROCESS, 1); 


/* Number of bytes in 


This is all we need until we register a class for the child win¬ 
dows. Note the use of the sizeof operator; a more complex pro¬ 
gram might use sizeof(struct _MyWindowData *) or sizeof 
(PPLANWINDATA) or some such construction. 

Now the NOGAM continues: 

/* Now register a window class for the application child windows */ 
if{IWinRegisterClass(hab, 

(PCH)szChildClassName, 

(PFNWP)HelloChildWndProc, /* Pointer to winproc function */ 

/* CSJSYNCPAINT I */ CS_SIZEREDRAW, /* Flags to force redraw 
when re-sized, etc. */ 

sizeof(char *))) /* Number of bytes in 'window words' */ 

DosExit(EXIT_PROCESS, 1); 


Again, the code looks the same as the single-windowed ver¬ 
sion, until we come to the creation of the child windows: 


WinAlarm(HWND_DESKTOP, WA_ERROR); 

DosExit(EXIT_PROCESS, 1); 

} 

But now we continue: 

hwndCl Frame = WinCreateStdWindowChwndParentClient, 

WS_VISIBLE, 

SulFrameFlags, 

(PCH)szChildClassName, 

"Hello Child 1", 

WS_VISIBLE, 

(HMODULE)NULL, 

0, 

(HWND FAR *)ShwndClClient); 
if(hwndCIFrame == 0) { 

WinAlarm(HWND_DESKTOP, WA_ERROR); 

DosExit(EXIT_PROCESS, 1); 

> 

hwndC2Frame = WinCreateStdWindow(hwndParentClient, 

WS_V1SIBLE, 

SulFrameFlags, 

(PCH)szChildClassName, 

"Hello Child 2", 

WS_VISIBLE, 

(HMODULE)NULL, 

0, 

(HWND FAR *)&hwndC2Client); 
if(hwndC2Frame =0) { 

WinAlarm(HWND_DESKTOP, WA_ERROR); 

DosExit(EXIT_PROCESS, 1)? 

) 

An alternative design approach I might have used — and one 
I do use on more complex applications — would be to put the 
code for the child window creation into the main window’s 
winproc, in the processing of the WM_CREATE message. 

Now, we set the window words to point to the appropriate 
strings: 


/* We want a regular window, but without a menu, accelerator table and 
icon */ 

ulFrameFlags - FCF_STANDARD & ~FCF_MENU & ~FCF_ACCELTABLE & ~FCF_ICON; 
/* Now go ahead and create the window */ 

/* This function call returns the frame window handle and also sets 
the client window handle */ 

hwndParentFrame = WinCreateStdWindow(HWND_ DESKTOP, /* Parent window 
*/ 


WS_VISIBLE, 
SulFrameFlags, 
(PCH)szClassName, 
"Hello", 
WS_VISIBLE, 
(HMODULE)NULL, 

Or 

(HWND FAR ’ 
window handle */ 
if(hwndParentFrame 


/* Window style visible */ 

/* pointer to frame flags */ 

/* Registered class name */ 

/* Text for title bar */ 

/* Client window style */ 

/* Pointer to resource module */ 

/* Resource ID within module */ 

&hwndParentClient ); /* Pointer to client 

- 0 ) < 


WinSetWindowPtr(hwndParentClient, QWL_USER, pszParentString ); 
WinSetWindowPtr(hwndCIClient, QWL_USER, pszCIString); 

WinSetWindowPtr(hwndC2Client, QWL_USER, pszC2String); 

It’s business as usual from this point, at least until the win¬ 
proc for the child windows: 

/* Now loop around processing events. This is called the 'event loop' 
*/ 

/* WinGetMsg returns FALSE when it gets the WM_QUIT message */ 
while(WinGetMsg(hab, &qmsg, 0, 0, 0)) /* Get a message */ 

WinDispatchMsg(hab, Sqrasg); /* Dispatch it to the window */ 

/* Lastly, clean up */ 

WinDestroyWindow(hwndParentFrame); 

WinDestroyMsgQueue(hmq); 

WinTerminate(hab); 

} 
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r The client window procedure. Gets called with message 
components as parameters V 

*/ 

WinPostMsg(hwnd, WM_QUIT, 0, 0); /* So send back WM_QUIT, causing 

*/ 

MRESULT EXPENTRY HelloWndProc(HWND hwnd, USHORT usMessage, MPARAM mpl. 

break; /* WinGetMsg to return FALSE and exit the event loop 

MPARAM mp2) 

{ 

*/ 

default: /* Let the system handle messages we don't */ 

HPS hps; /* Handle to a presentation space. This is where a 

return WinDefWindowProc(hwnd, usMessage, mpl. 

PM program 'draws' */ 

mp2) ; 

RECTL rc; /* A rectangle structure, used to store the window 

break; 

coordinates */ 

} 

switch(usMessage) { 

return 0L; 

case WM_CREATE: /* process this message by returning FALSE. 

} 

This lets the */ 


return (MRESULT)FALSE; /* system continue creating the window 

The child window is basically the same, except for changed 

*/ 

WM_CLOSE processing to destroy just this window, rather than 

break; 

to exit the application: 

case WM_ERASEBACKGROUND: /* Let the frame window procedure 

/* The child window procedure. Gets called with message components as 

parameters */ 

redraw the background */ 

MRESULT EXPENTRY HelloChildWndProc(HWND hwnd, USHORT usMessage, 

return (MRESULT)TRUE; /* in SYSCLR_WINDOW (usually white) */ 

MPARAM mpl, MPARAM mp2) 

break; 

{ 

The processing of the WM_PAINT message has to be modi¬ 
fied slightly from the single-window version of the program, in 
two important respects. First, the address of the string to be 
printed is no longer a static variable (though it could be in this 
example: there is only one parent window) and so we must use 
the WinQueryWindowPtr( ) function call to extract it from the 
window words. 

The second modification is less obvious. When one of the 
child windows is moved or minimized, thereby revealing a pre¬ 
viously hidden part of the parent window, the system will inval¬ 
idate that part (or parts) of the window and send WM_PAINT 
messages to the window. By default, when we call WinBegin- 
Paint( ), the micro-cached presentation space returned is the 
size of just the invalidated region. If we went ahead and called 
WinDrawText( ) to paint some text, it would appear centered in 
the invalidated region where the child window used to be, 
rather than centered in the client window area. 

For this simple application, the extra overhead of totally re¬ 
painting the client window area is neither here nor there, and 
an extra call to WinQueryWindowRect( ) fixes the problem: 

HPS hps; /* Handle to a presentation space. This is where a 

PM program 'draws' */ 

RECTL rc; /* A rectangle structure, used to store the window 

coordinates */ 

switch(usMessage) { 

case WM_CREATE: /* process this message by returning FALSE. This lets 

the */ 

return (MRESULT)FALSE; /* system continue creating the window */ 

break; 

case WM_ERASEBACKGROUND : /* Let the frame window procedure redraw the 

background */ 

return (MRESULT)TRUE; /* in SYSCLR_WINDOW (usually white) */ 

break; 

case WM_PAINT: /* The 'guts' of the application */ 

hps * WinBeginPaint(hwnd, 0, &rc) ; /* Get a presentation space */ 

WinQueryWindowRect(hwnd, &rc) ; /* Get the window dimensions */ 

/* Draw the message, in rectangle rc, colored CLR_NEUTRAL (black) on 

CLR_BACKGROUND (white), centered, over-writing the entire rectangle */ 

WinDrawText(hps, -1, WinQueryWindowPtr(hwnd, QWL_USER), &rc, 

CLR_NEUTRAL, CLR_BACKGROUND, 

DT_CENTER | DT_VCENTER | DT_ERASERECT) ; 

WinEndPaint(hps) ; /* Release the presentation space */ 

case WM_PAINT: /* The 'guts' of the application */ 

break; 

hps = WinBeginPaint(hwnd, 0, NULL); /* Get a presentation 

case WM_CLOSE: /* User chose CLOSE on system menu or double-clicked 

space */ 

*/ 

WinQueryWindowRect(hwnd, &rc); /* Get the window dimensions */ 

WinDestroyWindow(WinQueryWindow(hwnd, 

/* Draw the message, in rectangle rc, colored CLR_NEUTRAL 

QW_PARENT) ); 

(black) on 

break; 

CLR_BACKGROUND (white), centered, over-writing the entire 

default: /* Let the system handle messages we don't */ 

rectangle */ 

return WinDefWindowProc(hwnd, usMessage, mpl, mp2); 

WinDrawText(hps, -1, WinQueryWindowPtr(hwnd, QWL_USER), &rc. 

break; 

CLR_NEUTRAL, CLR_BACKGROUND, 

} 

DT_CENTER | DT_VCENTER l DT_ERASERECT) ; 

return 0L; 

WinEndPaint(hps) ; /* Release the presentation space */ 

> 

break; 


case WM CLOSE: /* User chose CLOSE on system menu or double-clicked 
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Using Data Structures 

More complex examples typically define data structures to 
store the data items represented by the window. In some cases, 
these are simple flat structures or possibly arrays of structures; 
in others, the initial data structure contains the head of a linked 
list of data items, or possibly a more complex structure such as 
a tree. 

Here’s a more complex example, taken from a real-world ap¬ 
plication (a flight planning program). Among the data struc¬ 
tures associated with a window is this one, defined in the ap¬ 
plication’s main header file as follows: 

typedef struct _DATAVIEW { 

NPDATAFILE npDataFile; 
struct _waypoint *buffer; 

LONG recno; 

BOOL RecordChanged; 

struct field *CurrentField; 

struct _DATAVIEW *npdataviewNext; 

} DATAVIEW; 

Because the memory for this structure is allocated and freed 
as required, we will almost always refer to it via a pointer, and 
so a pointer to a dataview structure is typedef d as follows: 

typedef DATAVIEW NEAR *NPDATAVIEW; 

(The near pointer distinction obviously does not apply in 
OS/2 2.x). 

Now, rather than typing out the WinQueryWindowPtr( ) 
function call again and again, we use a macro to extract a near 
pointer to the DATAVIEW structure from the client window, giv¬ 
en its handle: 

#define NPDATAVIEWFROMCLIENT(hwndClient) 

<(NPDATAVIEW)WinQueryWindowPtr(\ 
hwndClient, QWS_USER)) 

The window procedure for one of the windows which uses 
this data structure looks very familiar (I won’t show it all here 
— it’s much too large!). The idea of the basic structure is to ex¬ 
tract the pointer to the data structure right at the beginning of 
the function, since almost every message to be processed will 
involve the data in the underlying structure: 

MRESULT EXPENTRY FplFormWndProc(HWND hwnd, USHORT usMessage, MPARAM 
mpl, MPARAM mp2) 

HPS hps; 

RECTL rcl; 

int field_id; 

NPDATAFILE pdf; 

NPDATAVIEW pdv; 

pdf - NPDATAFILEFROMCLIENT(hwnd); 

pdv - NPDATAVIEWFROMCLIENT(hwnd); 

Later in the winproc, the variables are accessed by derefer- 
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encing through the appropriate pointer. For example, to skip to 
the next record in the nav waypoint database do this: 

pdv->recno++; 
and so on. 


Conclusion 

Window words are extremely powerful tools; almost any non¬ 
trivial program will require the ability to display multiple win¬ 
dows of a single class and to keep their data separate yet associ¬ 
ated with the appropriate display window. Even when writing 
almost trivial programs these days, I’ve taken to defining the ap¬ 
propriate data structures and setting up pointers to them in a 
window. Subsequent program enhancements are made much 
easier! 

The next article will deal with parent-child and owner-owned 
relationships among Presentation Manager windows. ♦ 
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ow Bullet in BO' 

ACROSS THE WORLD 

This list is a compilation of OS/2 BBS’s across the world. If you wish to make an addition or correction to 
this list, please netmail your BBS information to Dave Fisher at LiveNet, 1:170/110@fidonet.org. 

This list is distributed to many FidoNet nodes found in this OS/2 BBS listing via the Fernwood distribution 
system. All BBS’s listed are in alphabetical order by country, and then by BBS name. Unless otherwise not¬ 
ed, all node addresses are FidoNet. 

A current list can always be file-requested from LiveNet as ‘OS2WORLD’. 


Legend: -A : HST, MNP * : OS/2 is primary interest 
-B: HST, MNP V.32/V.42bis F: BBS is a FidoNet node 
-C: HST, MNP V.32bis/V.42bis % : Entry is new or changed 
-D: MNP V.32(bis)/V.42bis 
-E: MNP V.32 
-F: MNP V.42 
-G: PEP 

USA BBS’s show states, International BBS’s show three letter country 
codes. 

Graham Stair 3M Australia +61-2-498-9184 Aus9600-E*F 
lan Watson OZ-Share OS/2 BBS +61-7-398-3759 Aus 9600-E * F 
Alan Salmon PC User’s Group +61-6-259-1244 Aus 2400 
Felix Tsang Programmer’s BBS +61-2-875-1296 Aus 9600-E *F 
Bill Bolton Software Tools Mail Exc +61-2-449-2618 Aus 9600-E * F 
+61-2-449-9477 Aus 9600-E *F 

John Della-Torre The Poet’s Dilemma +61-2-804-6412 Aus 2400-E 
Werner Baar La Bamba-lst Austrian 0 +43-222-688971 Aus 14.4-C 

* F 

Norbert Fuerst The Styrian OS/2 Jumbo +43-316-673237 Aus 
9600-A * F 

Danny Bruggeman Hellfire +32-2-7515203 Bel9600-D*F 
Bas Heijermans Moving Sound OS/2 BBS +32-3-3850748 Bel 

14.4- D * F 

Benoit HUON Os/2 MANiA BELGIUM +32-2-3872021 Bel 9600-D * 
F 

Herbert Tsui BBS Council (604) 275-6883 Can 14.4-D * F 
lan Evans Baudeville BBS (4l6) 283-0114 Can 14.4-D * F % 

(416) 283-6059 Can 9600-A * F % 

Tony Bearman Bear Garden (604) 533-1867 Can 9600-C * F 
Brian P. Hampson CAGE, The (604) 261-2347 Can 16.8-C * F 
Evan Smith ECS Net (403) 253-5996 Can 14.4-C * F 
Chris Ange-Schultz Home Front BBS (514) 769-5174 Can 
2400 * F 

Peter Fitzsimmons RT Labs (4l6) 867-9663 Can 9600-B * F 
Ken Kavanagh Sound Stage BBS (604) 944-6476 Can 2400 * F 
(604) 944-6479 Can 16.8-C * F 
JoeLindstrom Telekon/2 BBS (403) 226-1157 Can 14.4-C * F 
(403) 226-1158 Can 2400 *F 

Gerry Rozema The Idle Task (604) 275-0835 Can 14.4-B *F 
Jerry Stevens TheLocutory (613) 722-0489 Can 9600-D *F 
Alec Herrmann The Nibble’s Roost (604) 244-8009 Can I4.4-B * F 
Kevin Lowey University of Saskatche (306) 966-4857 Can 14.4-C* F 
Herbert Kowalczyk iKonView (416) 635-1400 Can 2400 *F 
Jorgen Ollgaard Josti-BBS +45-47-380120 Den 9600-C *F 
+45-47-380524 Den 9600-C * F 

Rene Carlsen OS/2 Task & FrontDoor H +45-98451070 Den 9600- 
A*F 

Laurent Hycza, Eric D Lofty Cave BBS, The +33-1-6066-0587 Fra 
2400 * % 

Emmanuel Sandorfi Os/2 MANiA (Help Maximu +33-164-090460 
Fra 9600-C * F 

Peter Kaszanics APOLONIA +49-201-200382 Ger 9600-D * F 
+49-201-200381 Ger 9600-D * F 
+49-201-237509 Ger 9600-D * F 
Ulrich Roeding BOX/2 +49-89-6019677 Ger 14.4-D * F % 

Romeo Bernreuthcr CCWN-BOX +49-7151-68434 Ger 14.4-B * F 
Juergen Fritz Checkpoint OS/2 +49-7331-69116 Ger 9600-C *F 
Peter Plischka IBM Mailbox +49-201-210744 Ger 9600-C * F 
+49-201-295181 Ger 9600-B * F 

Juergen Berger JERRY’S OS/2-BBS +49-6134-26563 Ger 1 

4.4- D * F 

Oliver Lass LRZ-System +49-228-331214 Ger 2400 * 
+49-228-334372 Ger 9600-D * 

O.'iver Schwabedissen MoonFlower +49-6145-31602 Ger 9600-C 

* F 


Richard Clement OS/2 Express +49-6183-74270 Ger 9600-D *F 
Harald Kipp OS/2 Point +49-234-9279222 Ger 9600-B * F 
Michael Breukel PC Softbox OS/2 +49-6196-27799 Ger 2400 * F 
Markus Noller Second Source +49-7191-56267 Ger 2400 *F 
Kalle Braun TerraniaCity +49-228-317752 Ger 14.4-B F 
Thomas Tegel The CAT +49-7971 -72446 Ger 14.4-D * F 
Karlheinz Kissel The_File_Store +49-6106-22266 Ger 9600-C *F 
Chris Leuder Zaphod BBS +49-228-262894 Ger 14.4-B F 
+49-228-229147 Ger 2400 F 

Pasquale Cantiello FastForward BBS +39-823-812099 
Ita 14.4-C * F 

Luigi Ravina Italy Network +39-11-8180069 Ita 9600-A *F 
Roberto Sonzogni Runnin’ with The Devil +39-363-302798 Ita 
9600-C * F 

Peter Smink BBS The Experiment +31-1150-15245 
Net 9600-A * F % +31-1150-14498 Net 14.4-C * F % 

Joop Mellaart 1NFOBOARD +31-4752-6200 Net 2400 *F 
Marcel Stikkelman PC-Square +31-79-424107 Net 14.4-C *F 
Dave Jones The TJD Support BBS +31-1720-38558 Net 9600-A* 
Terje Slydahl PerlePorten +47-83-33003 Nor 9600-C * F 
+47-83-33003 Nor 2400 * F 

Ivan Leong Miqas/2 [Singapore! +65-755-6463 Sin 9600-C *F 
Walter Wu OS/2 Centre +65-274-0577 Sin 9600-D * F 
Alex Wyss Gepard’s Oracle Zuerich +41-1-3637037 Swi 14.4-C * F 
Michael Buenter MICS OS/2 Paradise +41-41-538607 Swi 
9600-C * F 

Ernesto Hagmann PC-Info +41-61-9412204 Swi 9600-C *F 
Mike Gove MonuSci BBS +44-0-454-633197 UK 9600-A * F % 
Mike Gove MonuSci Opus +44-45-453197 UK 9600-C F 
Phil Hick The TJD Support BBS +44-535-665345 UK 9600-C * 
+44-535-665345 UK 9600-A * 

MarkLehrer Akron Anomoly, The (216) 688-6383 OH 9600-C F 
Todd Riches Alternate Reality (206) 557-9258 WA 2400 F 
Bob Morris Ascii Neighborhood 1 & (203) 934-9852 CT 9600-G * 
F (203) 932-6236 CT 9600-C * F 
Patrick O’Riva Asm Lang and OS/2 (408) 259-2223 CA 14.4-B *F 
Bill Schnell Asylum BBS, The (918) 832-1462 OK 9600-B *F 
Scott Dickason BBS/2 (918) 743-1562 OK 2400 *F 
Thomas Bradford Backdoor BBS (919) 799-0923 NC 14.4-C *F 
Steve Lesner Bullet BBS (203) 329-2972 CT 9600-B * F 
(203) 322-4135 CT 9600-B *F 
Troy Majors Byte Bus, The (316) 683-1433 USA 9600-D * F % 
Bobjuge COMM Port One (713) 980-9671 TX 14.4-C *F 
Kerry Flint Caddis OS/2 BBS (702) 453-6687 NV 14.4-A*F% 

Rob Schmaling Caladan (203) 622-4740 CT 14.4-A * F 
Bob Germer Capital City BBS (609) 386-1989 NJ 14.4-C * F 
Mike Phillips Catacombs, The (317) 525-7164 IN 9600-A F 
Mark Woolworth Choice BBS, The (702) 253-6527 NV 16.8-C * F 
% (702) 253-6274 NV 9600-D * F % 

Dennis Conley Communitel OS/2 BBS (702) 399-0486 NV 14.4-C * 
F 

DaveShoff Cornerstone BBS, The (616) 465-4611 MI 14.4-D *F% 
William Herrera Cuerna Verde (719) 545-8572 CO 9600-D* F% 
Mike Fuchs Dog’s Breakfast, The (908) 506-0472 NJ 14.4-C F 
(908) 506-6293 NJ 2400 F 

Shawn Haverly Dugout BBS, The (817) 773-9138 TX 16.8-C * F 
(817) 773-9140 TX 2400 *F 

Mike Mahoney Emerald Isle, The (602) 749-8638 AZ 

14.4-C * F % 

Frank Ward Encounter, The (602) 892-1853 AZ 14.4-C F 
Felix Tang Excelsior, The (203) 466-1826 CT 14.4-C * F 
(203) 466-1892 a 2400 * F 
Emmitt Dove Fernwood (203) 483-0348 CT 9600-C * F 
(203) 481-7934 CT 14.4-B * F 

Bill Cook GREATER CHICAGO OnUne! (708) 895-4042 IL 9600 * F 
Rodney Lorimor Gecko Control (509) 244-0944 WA 9600-E * F 


Craig Oshiro Ghostcomm Image Gallery (808) 456-8510 HA 14.4- 
C * F % 

Stan Brohn HelpNet of Baton Rouge (504) 273-3116 LA 9600-C F 
(504) 275-7389 LA 9600-A F 

Bogie Bugsalewicz I CAN! BBS (312) 736-7434 IL 9600-C F 
(312) 736-7588 IL 2400 F 

IBM IBM National Support Ce (404) 835-6600 GA 2400 
(404) 835-5300 GA 9600-C 

Ed June Information Overload (404)471-1549 GA 9600-A *F 
Bill Taylor Integrated Media Servic (503) 667-2649 OR 14.4-D F % 
Mikel Beck Kind Diamond’s Realm (516) 736-3403 NY 

14.4- C* F% 

James Chance Last Relay, The (410) 793-3829 MD 14.4-D * F 
Robert McA Live-Wire (214) 307-8119 TX 9600-B F 
Operand BBS Lonnie Wall (901) 753-3738 TN 2400 *F% 

(901) 753-7858 TN 14.4-D * F % 

Edward Owens Looking Glass, The (901) 872-4386 TN 14.4-D *F 
Chuck Gilmore Magnum BBS (805) 582-9306 CA 9600-C * 

Joe Salemi Max’s Doghouse (703) 548-7849 VA 2400-A * F 
Bob Hatton Monster BBS, The (908) 382-5671 NJ 9600-A* 

Paul Breedlove Multi-Net (503) 883-8197 OR 9600-C * 

RonBemis Nibbles & Bytes (214) 231-3841 TX 9600-A F 
Craig Swanson OS/2 Connection (619) 558-9475 CA 14.4-D * F 
Craig Swanson OS/2 Connection (619) 558-9475 CA 14.4-D *F 
Pete Norloff OS/2 Shareware (703) 385-4325 VA 9600-C * F 
(703) 385-0931 VA 9600-C * F 

Woody Sturges OS/2 Woodmeister, The (314) 446-0016 MO 

14.4- C * F 

Don Bauer OS2 Exchange (904) 739-2445 FL 14.4-D * F 
Brady Flowers Oberon Software (507) 388-1154 MN 14.4-C* 
Unknown Omega-Point BBS (714)963-8517 CA 2400 
Troy Kraser Other World, The (904) 893-2404 FL 9600-D F 
Paul Beverly PMSC OnUne Resource (803) 735-6101 SC 

2400 * F 

Jim Sterrett Padded Cell BBS, The (504) 340-7027 LA 14.4-C * F 
Jim Sterrett Padded Cell BBS, The (504) 340-7027 LA 

14.4- C* F% 

Jay Tipton Play Board, The (219) 744-4908 IN 9600-A *F 
Richard Lee Psychotronic BBS (919) 286-7738 NC 9600-C F 
(919) 286-4542 NC 9600-A F 
Louis F. Ursini Quantum Leap (215) 967-9018 PA 2400 
David Dozier Roach Coach, The (713) 343-0942 TX 14.4-C * F 
Doug Palmer Rock BBS, The (512)654-9792 TX 14.4-D F 
(512) 654-9793 TX 2400 F 

Ken Rucker RucK’s Place/2 (817) 485-8042 TX 14.4-C * F 
Mark Wheeler SandDollar, The (407) 784-4507 FL 9600-A *F 
Michael Nelson SeaHunt BBS (415) 431-0473 CA 14.4-C * F 
(415) 431-0227 CA 14.4-A *F 
John Tarbox Singer Bear BBS (302) 984-2238 DE 9600-A F 
LeRoy DeVries Sno-Valley Software Exc (206) 880-6575 
WA 9600-C F 

Randy Edwards Socialism OnUne! (719) 392-7781 CO 9600-B *F 
Art Fellner Soldier’s Bored, The (713) 437-2859 TX 9600-C * F 
B.J. Weschke Sorcery Baord BBS, The (908) 722-2231 NJ 9600-C 
F (908) 704-1108 NJ 9600-C F 
Scott Street Space Station Alpha (302) 653-1458 DE 14.4-C * F 
Chris Regan Storm Front - OS/2, The (203) 234-0824 CT 
9600-A * F 

Ed Barboni System-2 RBBS (215) 631-0685 PA 9600-D F 
(215) 584-1413 PA 9600-D F 

Bill Andrus Systems Exchange, The (703) 323-7654 VA 9600-A * F 
Don Dawson Treasure Island (203) 791-8532 CT 14.4-C * F 
Richard A. Press U.S. Telematics (215) 493-5242 PA 9600-A F 
Unknown WSI BBS (901) 386-4712 TN 2400 
Michael Cummings Zzyzx Road OS/2 BBS (619) 579-0135 CA 
9600-D * F % 
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R E XXT RY 


Abstract 

This article walks a user through 
the facilities of the REXXTRY 
command. The REXXTRY com¬ 
mand provides OS/2 users with a 
unique and simple way to explore 
REXX commands without neces¬ 
sarily coding entire working pro¬ 
grams. The REXX procedures lan¬ 
guage was developed primarily for 
the novice, and this utility simpli¬ 
fies the beginner’s acclimation to 
new commands by allowing ex¬ 
perimentation and exploration on 
a single REXX instruction. Despite 
the usefulness of the REXXTRY 
command to new users, IBM has 
not chosen to document it well, 
or very thoroughly. 


Eloy 0. Cruz-Bizet is a 
systems architect and 
president of Skating 
Systems Integration in New 
York. He specializes in 
operating systems internals 
for MVS/ESA, NOVELL 
Netware and OS/2. He is 
currently completing two 
books on the OS/2 Netware 
Requester, and on OS/2 
REXX. You can reach him at 
(718)284-0555 


After spending much 
too much time prospect¬ 
ing for a name for this col¬ 
umn, I gave up. It appears 
that not many words go 
rhythmically or synergisti- 
cally with the sound 
“rexx.” The prehistoric 
Tyrannosaurus came to 
mind, all too often, but 
so what? Then, while 
proofreading, I noticed 
the frequency of the 
word “explore” in my 
text. REXXPLORATIONS 
was born. 

Last issue’s installment 
showed how simple it is 
to translate a batch file to the REXX language, 
and touched on the basic rules of incorporating 
OS/2 commands in a REXX program. We’ll con¬ 
tinue to explore and to expand on this object ex¬ 
ercise in the next issue of OS/2 Monthly. Our 
discussion will include examples of enhancing 
this REXX program with arithmetic expressions, 
logical comparisons, and string manipulation. 
But before going further with the capabilities of 
REXX, we’ll look into a facility provided in OS/2 
for testing REXX commands. This issue’s install¬ 
ment discusses REXXTRY, a command allowing 
the execution of a single REXX instruction, with¬ 
out the need to create an entire REXX program. 

Even though there are persuasive reasons to 
chose REXX over batch file programming, 
there are many more reasons to dump batch 
files. Most of these reasons derive from bitter 
objections to the sheer inconvenience of 
working with them. There hasn’t been a lot of 
effort put into providing users with simple and 
effective debugging facilities like those most 
higher-level language programmers take for 
granted. We’re left pretty much on our own to 
check out our batch programs, via trial and er¬ 
ror hacking. We’ve all experienced the familiar 


feeling that we’re operating in a vacuum, a 
consequence of working with a command sys¬ 
tem that refuses to help. This is both frustrat¬ 
ing and annoying. After all, 

"SYS1079: == was unexpected at this time" 

is hardly the most helpful of messages when 
you're trying to prove out simple batch files. 
However, most would agree, the newcomer to 
personal computing should be supported with 
a facility that allows him to experiment with 
the syntax of a single command to his heart’s 
desire, until he knows it well. 

REXXTRY Command 

The REXXTRY command is OS/2’s answer. It is 
intended to be a learning and prototyping 
tool permitting a user to test a single REXX 
command directly from the keyboard. Its ad¬ 
vantage is its ability to obviate the requirement 
to create an actual program, with an editor, 
just to experiment with one REXX command. 
Normally, each change to a command a user 
wants to test is done without the repetitive cy¬ 
cle of edit-save-test-edit. 

When keyed in at the OS/2 command 
prompt, REXXTRY establishes the REXX envi¬ 
ronment, and displays its own prompt as 
shown in Figure 1. At this point you merely 
type the REXX command whose function 
you’d like to observe, and it’s immediately 
executed. Any output of the command is 
shown directly below it. When the requested 
process returns error codes, these are also dis¬ 
played. Then, after each execution, a new 
REXXTRY prompt line is displayed. 


[C:\]rexxtry 

REXXTRY.CMD lets you interactively try REXX 
statements. 

Each string is executed when you hit ENTER. 

Enter "call tell" for a description of the 
features. 

Go on - try a few... Enter "exit" to end. 


Figure 1. The Primary REXXTRY Prompt 
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[C:\]rexxtry 

REXXTRY.CMD lets you interactively try REXX statements. 

Each string is executed when you hit ENTER. 

Enter "call tell" for a description of the features. 

Go on - try a few... Enter "exit" to end. 

say copies('again and ',2) /* too few */. 

again and again and 

.*... REXXTRY.CMD on OS/2 

say copies('again and ',8) /* too many */ __ 

again and again and again and again and again and again and again and 
again_ 

. REXXTRY.CMD on OS/2 

say copies('again and ',5) /* just right */ 

again and again and again and again and again and 
. REXXTRY.CMD on OS/2 


= (repeat command) 

again and again and again and again and again and 
. REXXTRY.CMD on OS/2 


Figure 2. Editing and Repeating in REXXTRY 


save = 'sample.cmd' 


/* This is a REXX program */ 


REXXTRY.CMD on OS/2 
REXXTRY.CMD on OS/2 


. REXXTRY.CMD on OS/2 

repeated = copies('again and ',5) /* repeat 5 times */ 

. REXXTRY.CMD on OS/2 

sentence » substr(repeated,1,lastpos('d repeated)-4 )||'.’ 

. REXXTRY.CMD on OS/2 

/* find the end of string, -4 and place a period */ 

. REXXTRY.CMD on OS/2 

say sentence 

again and again and again and again and again. 


save = w 


REXXTRY.CMD on OS/2 

REXXTRY.CMD on OS/2 


exit 


Figure 3. REXXTRY "SAVE" Session 


Now, let’s see what REXXTRY is, where it resides, and what 
it can do. The REXXTRY command, a.k.a.REXXTRY.CMD, is it¬ 
self a REXX procedure, and is found in the “OS/2” subdirectory 
of the boot drive. The PATH information is normally not re¬ 
quired to execute REXXTRY since a reference to the “C:\OS2” 
subdirectory is included on the “PATH=” entry within OS/2’s 
CONFIG.SYS. On the other hand, you’ll need it if you’d like to 
display or print the source code for REXXTRY. If you have no 
other examples of REXX code, this presents an opportunity to 
see it. But for those not well versed in REXX, the logic may not 
be easy to follow. 

Experimenting With REXXTRY 

For our first example we’ll be experimenting with a REXX built- 
in function, COPIES. This function reproduces a character string 
n number of times. So that in the example REXX statement 

SAY COPIES('again and ", 2) 

“again and” is reproduced two times and displayed on the 
screen. 

Let’s test out this statement with REXXTRY. First invoke 
REXXTRY at the command prompt of an OS/2 full screen ses¬ 
sion or windowed session. Start by trying the command state¬ 
ment as is, then modify it. 

Suppose we want to change the command to iterate the char¬ 
acter string 8 times. It’s simple. Use the —> (right arrow) or F3 
to recall the command from the keyboard buffer. Position the 
cursor under the 3, and change it to 8. Now to complete the 
statement, press F3 again to reproduce the remainder of the 
command text, and press ENTER. The string is now iterated 8 
times. See Figure 2. 

Abbreviated Functions 

Three characters, “?,” and (null), when entered at the 
prompt, have special meaning to REXXTRY and invoke special 
functions. The equal sign (“=”), entered alone, indicates to 
REXXTRY that you’d like to re-execute the last command, with¬ 
out change. The question mark, when entered alone, invokes 


the “Procedures Language/2 REXX Help Information” folder. 
This is an OS/2 Presentation Manager application which pre¬ 
sents a comprehensive hypertext help guide, and reference, on 
the REXX language. Finally, hitting the ENTER key or blanks fol¬ 
lowed by ENTER is interpreted as a null string; no execution 
takes place, and you are reissued the prompt. 

REXXTRY Collection File 

But there’s more. Using REXXTRY, you can build a REXX pro¬ 
gram, one line at a time, in a file. The “SAVE =” function in 
REXXTRY permits you collect the instructions you execute, if 
this mode is toggled ON. You identify the collection file by 
equating the filename as a character string to SAVE, an internal 
variable of the REXXTRY program. When REXXTRY is started 
the value of the SAVE variable is null (“”). This implies that no 
collection should take place. When SAVE’s value is not null, but 
is set to a valid filename, REXXTRY opens the named file and 
starts collecting instructions. The file is written (appended to) 
for as long as SAVE = “filename.” 

From that point on, REXX commands entered at the key¬ 
board are saved to this file until “save mode” is toggled OFF. In 
this way you can test a REXX instruction until you have it the 
way you like it, turn on the “SAVE = ’’mode, then re-execute the 
command to capture it to the file. To turn off command collect¬ 
ing, reset the value of SAVE to null, e.g. “SAVE = 

In the example shown in Figure 3, a small REXX program be¬ 
ing tested is collected to a file using REXXTRY. Prior to in¬ 
putting the instructions, the “save” mode is invoked . The col¬ 
lection file is designated SAMPLE.CMD. Recall that OS/2 REXX 
procedure file names must end in .CMD. 

As intimated before, the output file is always (and only) 
appended to while it’s active. This is true even if you end and 
restart a REXXTRY session. There is no method for overlaying 
the contents of an existing file. This means that if you wish 
to start anew, with an empty file, you must either exit 
REXXTRY and delete the file, or specify a different filename. A 
listing of the file created by our example, SAMPLE.CMD, is 
shown in Figure 4. 

One word of caution. Although the REXXTRY SAVE function 
is useful and convenient, it isn’t smart enough to tell what it 
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REXXPLORATIONS: EXPERIMENTING WITH REXXTRY 


[C:\Jtype sample.cmd 
/* This is a REXX program */ 

repeated - copies('again and ',5) /repeat 5 times */ 
sentence = substr(repeated,1,lastpos('d repeated)-4 )||'. 
say sentence 

[C: \] 


Figure 4. File Created by REXXTRY Session. 

should and shouldn’t write to the file. Although it seems logical 
that REXXTRY might justifiably filter out REXX instructions that 
have failed syntax checking or those that are erroneously exe¬ 
cuted, it can’t. You might also expect that it would filter out the 
three special characters “?”, and replacing them with 
their long hand equivalents; it doesn’t. Correct instructions, er¬ 
roneous ones, and special characters are transferred unchanged 
to the collection file. That’s not all bad news. The null re¬ 
sponse, for instance, generates a blank line in the REXX com¬ 
mand file. This may very well be what you wanted. 

But even though these superfluous entries exist in the col¬ 
lection file, they may simply be deleted with an editor. The re¬ 
sulting file, containing only the remaining valid REXX state¬ 
ments, is a fairly well tested REXX program. 


/* SAA-portable REXXTRY procedure 11/08/91 version 1.05 
Owned by IBM SAA REXX Development, Endicott, New York. 

Loosely derived from an ancient formulation of Mike Cowlishaw 
This procedure lets you interactively try REXX statements. 

If you run it with no parameter, or with a question mark 
as a parameter, it will briefly describe itself. 

You may also enter a REXX statement directly on the command line 
for immediate execution and exit. Example: rexxtry call show 
Enter 'call show' to see user variables provided by REXXTRY. 

Enter to repeat your previous statement. 

Enter '?' to invoke system-provided online help for REXX. 

The subroutine named 'sub' can be CALLed or invoked as 'sub()'. 
REXXTRY can be run recursively with CALL. 

Except for the signal instructions after a syntax error, this 
procedure is an example of structured programming. 

The 'clear' routine illustrates system-specific SAA-portable coding. 
*/ 

rc - 0 . REXXTRY.CMD on OS/2 


Figure 5. Output from CALL TELL 

Callable Subroutines of REXXTRY 

The last topic is a facility available via the CALL command func¬ 
tions in REXXTRY. Three internal subroutine calls, CALL HELP, 
CALL TELL, and CALL SHOW provide informative responses 
useful to the user of REXXTRY. 

CALL HELP is identical in function to the invoking the 
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Icon Manager and OS/2 Icon Library 



A breakthrough operating system like OS/2 deserves a breakthrough icon manager 
and library. After all, you're not taking full advantage of object-orientation if the 
most important objects - YOUR programs and data files - all look alike. 

Now you can easily assign the icons of your choice to related programs and data 
files in a SINGLE procedure, and let ICONtrol! do the busy work for you! And, 
ICONtrol! works AUTOMATICALLY to keep your desktop icons up-to-date 
as new data files are added to your system! 

ICONtrol! includes the finest, most comprehensive library of OS/2 icon files ever 
assembled - over 300 dazzling images - in both large AND small formats. And, 
with the unique "Look-before-you-load" feature you don't have to load the entire 
library to use it - saving you time and disk space. 
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(714) 524-5851 
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REXXTRY.CMD provides these user variables. _ 

The current values are... _ 

'version' - 'REXXSAA 4.00 08 Jul 1992' _ 

'source' - 'OS/2 COMMAND C:\OS2\REXXTRY.CMD' _ 

'result' - 'RESULT' _ 

Previous line entered by user. Initial value*INPUTRX. _ 

'prev' - 'INPUTRX' _ 

'current' - 'call show' — 

Save your input with save=filespec. Stop saving with save*''. — 
'save' * '' _ 

Enter trace*i, trace-o etc. to control tracing. 

'trace' * 'Off' 

rc - 0 ... REXXTRY.CMD on OS/2 


Figure 6. Output from CALL SHOW. 


See Figure 5. The first set show the version and operating sys¬ 
tem running; the second set, the current and previously exe¬ 
cuted command; the third, the current value of the “SAVE =” 
variable; and the last, the current status of REXX trace. 

We’ve seen how any valid REXX instruction may be tested 
and experimented with. Despite the imperfections of 
REXXTRY, it’s a pretty useful tool for experimentation and 
REXXPLORATION. Use it frequently and speed up your discov¬ 
ery and mastery of REXX. Hopefully this type of hands-on inter¬ 
active play will be effective in helping you understand the func¬ 
tioning of REXX instructions. 

In the next installment of REXXPLORATIONS we ll investi¬ 
gate character strings and some string manipulation 
functions. ♦ 


REXX help Presentation Manager Information application. In 
contrast to the “?” function, the actual text of the CALL is writ¬ 
ten to the collection file when save mode is active. CALL TELL 
provides a snapshot tutorial of REXXTRY usage. See Figure 5. 

The CALL SHOW function displays a listing of the values of 
internal status variables of REXXTRY. These are useful to expe¬ 
rienced REXX programmers. Four groups of variables are listed. 



Bibliography: 

M. F. Cowlishaw. The REXX Language , A Practical Approach to 
Programming , Prentice-Hall, Inc., Englewood Cliffs, NJ, 
(1990) 

IBM Operating System/2 Procedures Language 2/REXX, Users 
Guide , S01F-0283, IBM Corp. (1992) 

IBM Operating System/2 Procedures Language 2/REXX, Ref¬ 
erence, S01F-0271, IBM Corp. (1992) 

OS/2 1.3 readers may find a simple introduc¬ 
tion to REXX in IBM Operating System/2 
Users Guide , Volume 1: Base Operating Sys¬ 
tem, S01F-0289, IBM Corp. (1990) 

On-line information is available in OS/2 Ver¬ 
sion 2.0 in the Information Folder “REXX In¬ 
formation” (1992) 


BM’s “Service Pak” (Corrective Service 
Package) for OS/2 (PTF XR06055) has de¬ 
livered maintenance and upgrades cor¬ 
recting problems in REXX, and has result¬ 
ed in replacement of all REXX modules. 
In the interest of keeping current with 
fixes, or if you’re currently experiencing 
problems with REXX, the Service Pak 
may be what you need. IBM offers the 15 
diskette Service Pak for $24.95 through 
their Service Pak Order Center at (800) 
347-6672. 

Listing of the APAR’s (registered prob¬ 
lems) corrected by the Service pack may 
be acquired from the IBM Software Sup¬ 
port Center at (800) 237-5511 
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CASCADE 


CONDITIONAL CASCADE MENUS 


Larry 

Moore 


Code for 
Cascade Menus 
can be found 
on the 
OS/2 
Shareware 
BBS, 
Section 17. 
703-385-4325. 


O ne of the many new features in OS/2 
2.0 is a new type of menu called the 
conditional cascade menu. A condition¬ 
al cascade menu is a menu that contains one or 
more mutually exclusive menu options, called 
cascades. When a cascade is displayed, a check 
mark identifies the default option. The condi¬ 
tional cascade menu itself contains the menu 
text followed by a push button. When the but¬ 
ton is selected, the cascade appears. When the 
conditional cascade menu is selected, the 
system takes action on the default item in the 
cascade. 

One of the most common examples of a con¬ 
ditional cascade menu is the folder popup 
menu. The folder popup menu contains three 
conditional cascade menus: “Open,” “Help,” and 
“Create another.” Looking at “Open,” if the but¬ 
ton to “Open” is selected, the cascade appears 
with four options, one of them being the de¬ 
fault (the default is usually “Icon View”). If an 
item in the cascade is selected, the folder opens 
the appropriate window. If “Open” is selected, 
the default cascade item is opened. 

Listed below is a sample application that 
demonstrates the use of the conditional cascade 
menu. The window contains a menu called 
“Strings” that, when selected, brings up a condi¬ 
tional cascade menu called “Display.” If the “Dis¬ 
play” button is selected, a cascade appears with 
three items called “String 1” “String 2” and 
“String 3” Notice that “String 3” is the default 
item because that item is checked. If one of 
these items is selected, the corresponding menu 
item string is displayed on the window. If “Dis¬ 
play” is selected, the application will display 
“String 3” on the window, because “String 3” is 
the default cascade item for “Display.” 

In order to create a conditional cascade 
menu, the menu first has to be set up as a stan¬ 
dard submenu with menu items. CASCADE.RC 
lists “Display” as a submenu with “String 1” 
through “String 3” as the submenu items. 
CASCADE.C converts the submenu to a condi¬ 
tional cascade menu when the WM_CREATE 
message is intercepted. When that message is 
received, a call to WinWindowFromID re¬ 
trieves a handle from the menu ID. When the 
handle is retrieved, the menu’s reserved word 
must be updated with the MS_CONDITIONAL- 
CASCADE flag, then inserted back into the 
menu. Once the word is updated, the menu 


is now a conditional cascade menu. 

Once the conditional cascade menu has been 
created, it is a good idea to set the current cas¬ 
cade item. When the conditional cascade menu 
is created, the first cascade option becomes the 
default. But no check mark is automatically set 
to the first cascade option, so it is a good idea 
to set the default option. This is done by calling 
WinSendMsg, with MM_SETDEFAULTITEMID as 
the message ID and the default cascade option 
as the first extra parameter. The example calls 
WinSendMsg with ID_STRING_3 as the default 
item. The system responds by setting “String 3” 
as the default option, whereupon a check mark 
is displayed at the menu option. If a change in 
the default option is desired, just send another 
MM_SETDEFAULTITEMID message with the 
new default menu option. Each time a new de¬ 
fault option is selected, the system will remove 
the check mark next to the old default and in¬ 
sert the mark next to the new default option. 

Although the default option check mark is 
maintained by the system, the check can be 
added or removed manually the same way that 
standard check marks are edited. Manually 
adding or removing check marks in the cascade 
will not change the default item. Each time a 
new option is selected, the only cascade op¬ 
tions that are affected are the old and new de¬ 
fault options. Check marks placed next to unaf¬ 
fected cascade options will not be changed, so 
it is possible to have more than one checked 
cascade option. 

The next item to discuss is how a condition¬ 
al cascade menu selection is processed. For 
most standard menu items, if the item is select¬ 
ed, the corresponding item ID is sent — which 
can be intercepted by the window’s procedure. 
But when a conditional cascade menu is select¬ 
ed, the ID of the default cascade item is sent in¬ 
stead of the ID of the cascade menu. In CAS¬ 
CADE. RC, the default conditional cascade 
menu has been assigned the ID of ID_DISPLAY; 
but when “Display” is selected, ID_STRING_3 is 
sent, because that is the ID of the default cas¬ 
cade item. If the default cascade ID is changed, 
the new ID is sent when “Display” is selected. 

Conditional cascade menus are excellent for 
menu selections that benefit from a default op¬ 
tion. They allow the user to select a default op¬ 
tion from a list of options, while still allowing 
the user to select all options, if desired. ♦ 
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A MULTIMEDIA CRASH COURSE 



cation about “new paradigms” and “the changing face of soci- consume the lion’s share of the typical hard drive, 
ety” and just get to some of the technical facts of what has be¬ 
come known as multimedia. COMPRESSION 


WHAT IS IT? 

Multimedia generally means using a computer to play sound, 
show color pictures and play movies. This is interesting because 
more information can be communicated using sound, color and 
motion than with text alone. 

WHAT KIND OF HARDWARE IS REQUIRED 

The reason multimedia has become a topic of discussion recent¬ 
ly is that hardware is now powerful enough to support the 
prodigious processing requirements. The minimum configura¬ 
tion for sufficient power is about an 80386SX 20 MHz IBM 
clone. In fact, at today’s prices, get an 80486 at 25 MHz with at 
least 8 megabytes of RAM. As for the Mac, a Ilci is up to the job, 
but the Quadra delivers much more firepower. On the Mac 
sound is built in; on the Intel platforms you need to add a sound 
card. On both platforms, better plan on buying a CD-ROM play¬ 
er. You’ll also want a monitor capable of supporting the refresh 
rates for the higher color pixel depths. Rather than have me rec¬ 
ommend name brands here, it is enough to know to ask about 
these things when you upgrade your system. If the salesperson 
can’t answer your questions, don’t buy — keep checking around 
until you understand what is required. 

TWO BIG PROBLEMS 

There are two big problems with multimedia: one, it requires a 


One obvious solution is to buy lots of disk space, but it’s a lot 
cheaper to compress the data and decompress it when you want 
to use it. Compressed data not only takes less room to store but 
also less time to move from place to place. Consequently, among 
the most jealously guarded secrets in computing today are com¬ 
pression algorithms. There are two families of compression: 
“lossless” and “lossy”. Lossless compression means that when 
the data are decompressed you get back an exact bit for bit copy 
of what was originally compressed. Lossy compression means 
that you get back data that are good enough but not exactly 
what was compressed. Lossy compression is desirable because 
human perception is such that some data loss is not noticed. So 
with lossy compression you lose an almost imperceptible 
amount of information while enjoying significant improvements 
in compression speed and storage. 

There are other techniques that can cut down on data re¬ 
quirements. For example, with video, the difference between 
frames can be stored, instead of each frame in its entirety. In this 
way the system only has to deal with the occasional large refer¬ 
ence video frame. Then, for subsequent frames, all that is stored 
is the difference from the last frame. For example, if a video clip 
consists of a person talking, it is possible that just the lips are 
moving while the eyes, nose and hair are the same for several 
frames in a row. It make sense to store just one picture of the 
head and then store the change in the pixels around the lips for 
subsequent frames until the head moves again. 
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COLOR 

Another way to save space is to compromise on image quality. 
For a monochrome picture (black and white) each pixel on the 
screen can be represented in one bit (say 0 for black and 1 for 
white). For a sixteen color (or sixteen grays) picture you need 
four bits to represent each color. So the same picture of your pet 
dog takes four times as much space if it is stored in sixteen col¬ 
ors rather than in black and white. Sixteen colors is sometimes 
called “four-bit” color. You get closer to photo realism with more 
colors. Typically you will find “eight-bit” color (256 colors), “six¬ 
teen-bit” color (32,000+ colors) and “24-bit” or “true color” (mil¬ 
lions of colors). 

On some systems you may even find “32-bit” color, although 
it’s generally accepted that 24-bit color provides more color 
shades than can be perceived by human vision. So a photo¬ 
graphic quality picture of your pet pooch takes 24 times as 
much space as a black and white picture. 

With eight-bit color video images it is normal to associate a 
palette with the image. A palette is a selection of 256 colors 
that best make the image look photo realistic. This means that 
an eight-bit color video card is usually capable of presenting 
more that 256 colors but only 256 at one time. An eight-bit col¬ 
or image file will contain a table of the preferred 256 colors 
that best show the image. 


SOUND 

We find a very similar situation with sound. Analog sound needs 
to be “sampled” so many times a second to approximate the 
sound wave. The more samples per unit time, the higher the 
quality of the sound playback. When you buy a CD-ROM of your 
favorite musical group it is generally 44 khz (44,000 cycles per 
second) and two channels (i.e., stereo). By the way, music CD- 
ROMs can be played on your computer but they are in fact not 
in the same data format as data CD-ROMs. This means they re¬ 
quire a special software driver to decode the music format. Any¬ 
way, the higher the sample rate, the more data you have to 
store and move. Typically sound is sampled at 11 khz, 22 khz, 
or 44 khz. So 22 khz sampling takes twice as much data as 11 
khz. Add to that the fact that if you want stereo, double the 
amount of data again. So 22 khz stereo requires four times as 
much data as 11 khz mono. Then there is the question of the 
sample format. There are eight-bit samples and sixteen-bit sam¬ 
ples. This is yet another quality/data tradeoff, sixteen-bit sam¬ 
ples will be higher quality yet require twice as many bytes. 

CD-ROM 

CD-ROMs are capable of holding over 600 megabytes of data. 
Consequently, they are a natural for multimedia applications. 
You can hold mountains of text on one CD-ROM. Similarly, you 
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A Complete Performance Measurement Package 
for the OS/2 2.0 Operating System 


Easy to use: 

• Presentation Manager and Workplace 

• Easy access notebook style interface 

• Full on-line help, with hyper-text links 

• Separate on-line documentation 

• Graphical Installation 

Benchmarking Power: 

• 32 bit 80386 Code 

• 25 benchmark tests in all 

• Disk drive and diskette drive tests 



• Logging Facility to save and/or print results 

• Computational benchmarks for integer and floating point math 

• Powerful Macro Feature to facilitate test suites, using IBM Rexx 

• 2 high-level benchmarks designed for use in comparing systems 

• 8 video benchmarks that use the OS/2 Graphics Programming Interface (GPI) 


Benchmarks that matter: 

• Designed to access resources and OS/2 system code like OS/2 applications 

• OS/2 Application Tests (requires Excel for OS/2 and/or Describe) 

• Specify your own OS/2, DOS, or even Windows-OS/2 tests 

• Examine the effectiveness of memory cache 


Available for ■ limited time for just $79.95. 

To order call 
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Shipping and handling charges extra. Visa/Mastercard and 
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OS/2 "BATCH MANAGER" 
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BATCH JOBS (OS/2 COMMAND FILES) 



Jobs can be executed upon request, 
scheduled to execute at a delayed 
time/date, or to run recurringly. 
SAA/CUA compliant. 
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To order or for more information contact: 
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Palm Harbor, FL 34683 
Tel: 813/786-4567 
Fax: 813/786-4765 

Product is registered in IBM's SAA Catalog, and is listed in 
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IBM, OS/2, and SAA are the registered trademarks of the 
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Now... 


UCANDU Visual Programming 
- with REXX 


.. OS/2's time may be here, 
thanks to a $299 tool called 
Visual Programming with REXX 
which brought the house down 
at a recent OS/2 conference in 
Colorado.. .it is to REXX and 
OS/2 what Visual Basic is to 
Windows and DOS.” 

-Robert X. Cringely 
InfoWorld, January 25, 1993 
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Now you can unleash the power of the REXX language in a GUI 
environment with an easy-to-use visual programming tool. 
UCANDU Visual Programming with REXX offers a CUA ’91 
interface, WYSIWYG editors, and drag-drop programming— 
features that allow you to visually construct OS/2 2.0 
applications in record time. 

Who says powerful results can’t be easy 
to achieve? 

Because VP is completely integrated with the OS/2 2.0 
Workplace Shell, you can leverage your existing skills. 

VP offers multiple views, drag-drop interaction, pop-up menus, 
settings notebooks, direct editing, and other CUA ’91 features, 
and supports the OS/2 2.0 font and color palettes. Even users 
with little or no knowledge of programming become productive 
VP users in no time. 

Here’s what UCANDU 
with Visual Programming: 

• Quickly prototype and develop OS/2 2.0 CUA ’91 applications 

• Generate a small, single .EXE file for license-free distribution 

• Build client-server programs 

• Migrate existing REXX procedures to the OS/2 2.0 
GUI environment 

UCANDU Visual Programming with REXX gives you access to 
these OS/2 2.0 programming features: 

• Buttons, lists, graphics, sliders, and all the CUA ’91 controls 

• Business graphics 

• APPC, HLLAPI, and OS/2 2.0 Database Manager 

Best of all, it’s small 

System requirements: 

OS/2 2.0,5 Mb memory, 

2 Mb hard disk space 

$299 

Introductory price 

OS/2 2.0, CUA, and Workplace Shell 
are registered trademarks of 
International Business Machines Corporation. 


UCANDU" 

SOFTWARE 

P.O. Box 336 
Cary, NC 27512-0336 

Sales (919) 387-7391 
Tech Support (919) 380-0616 
Fax (919) 380-0757 

© 1993 Ucandu Software, Inc. 
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A MULTIMEDIA CRASH COURSE 


can store lots of 24-bit color images on a CD-ROM, perhaps as 
many as 200. As for full motion video with sound, it depends 
upon the parameters discussed above. Silent video clips take up 
fewer bytes than do sound movies; black and white video takes 
fewer bytes than color, low quality sound takes up fewer bytes 
than higher quality sound, etc. Add to all this the type of com¬ 
pression being used: the better the compression, the more 
video you can store on a CD-ROM. 

The bad news is that you still have to move the data from the 
CD-ROM into the computer for playback. For 24-bit color still im¬ 
ages this is just a matter of how long you wait for the picture to 
appear on the screen. But for full motion video it becomes criti¬ 
cal how fast the machinery can deliver data from the CD-ROM 
drive to the computer. In addition, the computer then needs to 
be able to quickly decompress the image. Right now most rea¬ 
sonable CD-ROMs can deliver 150 kilobytes per second to the 
computer. Recently, double speed CD-ROMs have been devel¬ 
oped that can deliver twice that. As a practical matter, right now, 

90 kilobytes per second is about all one can count on. This 
means that there are data formats that simply have too much data 
to be delivered from the CD-ROM to the computer. For example, 
24-bit color uncompressed video with sixteen-bit 44 khz stereo 
sound cannot be delivered at a frame rate that looks like smooth 
motion. What this means is that video playback software needs to 
be prepared to respond to data that fall behind. Usually what this 
means is that sound chunks and movie frames are discarded in or¬ 
der to keep the flow of the video on schedule. 

STANDARDS 

One of the big issues right now is whose standards will prevail 
in the marketplace. There are several important standards being 
contested today. The stakes are enormous. The victors in these 
battles will control the hearts and minds of the hardware ven¬ 
dors and software manufacturers. 

First of the standards is hardware. This issue involves min¬ 
imum speed for CD-ROMs, sound card formats and video card 
formats. Microsoft, in its quest to control just about everything 
about desktop computing, has worked with other vendors 
to invent the MPC standard. MPC defines how fast the CD- 
ROM, sound and video must be. Meanwhile, Apple has a 
defacto standard in its hardware platform. Meanwhile, Sony 
and Kodak are jumping into the fray with some television 
oriented standards such as the Kodak Photo CD and CDI for¬ 
mats. Its enough to know that this battle is not yet over. It is 
very similar to the battle that once raged over VHS and Beta- 
Max video. The final disposition may very well be that multiple 
formats will co-exist. 

Another standard involves compression. This area is chang¬ 
ing on an almost monthly basis. There are several excellent 
compression techniques. There are different philosophies at 
work with compression. In some cases you want a rapid com¬ 
pressor, while decompression can be slower (for example, in 
video capture). In other cases compression speed is unim¬ 
portant but decompression speed is critical (for example, in 
full motion video playback). In still other cases the quality of 
the decompressed image must be perfect. And in still other cas¬ 
es, quality loss is acceptable in return for tight compression. 
The point is that the selection of a compressor depends on the 
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application s needs. Look for significant changes in this area 
in the next year. 

Another standard involves data formats. At this writing there 
are at least two full motion video data formats for the mass 
consumer market and other animation data formats. Autodesk 
has a well accepted DOS animation data format characterized as 
the .FLI File format. Apple has the QuickTime full motion video 
and sound format. Microsoft has the .AVI (Audio Video Inter¬ 
leave) format which it has introduced this year in its Video for 
Windows product. There are others in the professional arena, 
as well as some in the mass market, such as the Amiga (which 
has been a long time multimedia platform with an excellent 
reputation). 

GETTING MULTIMEDIA MATERIAL INTO THE SYSTEM 

By far the most asked question is “How do you get video and 
pictures into the computer?” The answer is simple. To digitize 
color pictures, use a color scanner. There are hand held models 
as well as flat bed scanners. A quality flat bed color scanner is 
currently in the $1,000+ price range. With such a scanner, 24- 
bit color image scanning is possible. 

For video, a hardware capture card is required. This technol¬ 
ogy is quite familiar to Macintosh multimedia users, less so to 
Intel based processor users. Basically, one buys a hardware card 
that accepts video input in NTSC (United States) or PAL (Euro¬ 
pean) format. Any video source works: laser disk, video tape or 
direct television signal. One of these video capture cards can 
cost from $300 on the Intel PC side (for example, the Media Vi¬ 
sion VideoBlaster Card) to as much as you want to spend. Intel 
is offering a video capture technology as well as a compression 
technology that complements it. 

Currently there is a better selection on the Mac, but this is 
changing rapidly. Two popular Mac capture cards are the Video 
Spigot (around $500) and the Radius (around $2,000). These 
prices change very rapidly these days and some of the hardware 
cards provide additional features, such as 24-bit color video sup¬ 
port and integrated sound capture support. It is recommended 
that you research these items carefully and compare feature sets 
as well as price. In some cases the rate at which the cards can 
capture video makes them little more than toys. 

IN SUMMARY 

The multimedia market is a swirling, changing beast. Be prepared 
to see rapid changes in the near future. This article is a snapshot 
of just a very few of the issues at hand. Indeed, we’ve barely 
scratched the surface. Some other interesting areas of exploration 
would be rendering images, video editing software, presentation 
authoring software and the creation of CD-ROM tides. ♦ 


Frederick Gault, Jr. is Vice President of San Francisco Canyon 
Company, Inc., specializing in OS/2 and Windows programming. 
Recently his company has embarked upon the production of 
Multimedia titles, their first, Canyon Action! is a collection of 
QuickTime music videos and true color still photos. Fred can be 
reached at 300 Montgomery; Suite 789, San Francisco, CA 94104; 
Phone 415-398-9957; CompuServe ID 71531,2412 
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Batch Manager 

This product provides the user with a method 
of managing a delayed execution job queue. 
The delayed execution job queue is a concept 
that has been used for years in mainframe and 
minicomputer installations. This concept al¬ 
lows users to queue up jobs during regular 
working hours and have them execute either 
immediately or during the evening when com¬ 
puter usage is lower. 

Batch Manager allows the user to manage 
the delayed execution job queue via an OS/2 
Presentations Manager program. The program 
has two main menu functions and a help 
function. 

The QUEUE function provides the user with 
five sub-functions. The HOLD QUEUE sub¬ 
function places the queue in a hold state. The 
hold state affects all jobs currently in the 
queue and all jobs added to the queue after 
the hold queue option was selected. Jobs that 
are in a hold state will not execute until a re¬ 
lease command is issued for a particular job or 
for the entire queue. The RELEASE QUEUE 
sub-function releases all jobs currently in the 
queue and removes the effect of a previously 
issued HOLD QUEUE command. 

In other words, after the issuance of a RE¬ 
LEASE QUEUE command all jobs currently in a 
hold state within the queue will be released to 
be executed in their proper order and jobs 
subsequently added to the queue will not be 
held. 

The HOLD ALL JOBS sub-function holds all 
jobs currently in the queue but has no effect 
on jobs added to the queue subsequent to the 
issuance of the HOLD ALL JOBS command. 

The RELEASE ALL JOBS sub-function releas¬ 
es all jobs currently in the queue but has no ef¬ 
fect on jobs added to the queue after the is¬ 
suance of the release all jobs command. 

The CANCEL ALL JOBS sub-function simply 
deletes all jobs from the queue. The user is 
presented with a dialog box before the jobs 
are deleted. The text within the dialog box 
should be modified to indicate that the user is 
about to delete all the jobs in the queue. The 
text in the dialog box reads as follows: “Are 
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you sure that you wish to cancel this job.” The 
wording implies that the user is only deleting 
a single job. This could be a problem if the 
user inadvertently selects the cancel option 
from the QUEUE menu item instead of the can¬ 
cel option from the JOB menu item. It appears 
that the same dialog box was used for both 
cancel options. This change would require 
minimal effort from the developer and should 
appear in a future release. 

JOB Function 

The JOB function allows the user to change 
the status of individual jobs within the queue. 
The job function accomplishes this task via six 
sub-functions. The DETAILS sub-function dis¬ 
plays information such as the job ID, job 
name, start date, start time, status (pending, 
holding, active or delayed), single/recurring 
job type, recurring period, elapsed time and 
the .CMD file name for the job. The CANCEL 
JOB sub-function allows the user to delete an 
individual job from the queue. The user is pre¬ 
sented with a confirmation dialog box to pre¬ 
vent the accidental cancellation of a job. The 
HOLD JOB sub-function allows the user to 
place an individual job into a hold state so that 
it will not be executed until a release com¬ 
mand is issued that affects the job previously 
placed on hold. The RELEASE sub-function re¬ 
leases an individual job selected by the user. 
The SUBMIT sub-function allows the user to 
set up and submit a job for one time execution 
or recurring execution. The UPDATE sub-func¬ 
tion allows the user to update the parameters 
for a selected job, provided the job is not cur¬ 
rently being executed. 

BM-SUBMIT 

In addition to the on-line submit capability, 
Batch Manager provides a program named BM- 
SUBMIT which allows submission of jobs to 
the queue from the OS/2 command line, from 
a .CMD file or via a call to BMSUBMIT from an¬ 
other program. 

BMSUBMIT has six possible parameters. The 
COMMAND FILE parameter is mandatory and 
must be the fully qualified file name of the 
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OS/2 command file (.CMD) to be executed. The JOB STATUS 
parameter is optional. If the JOB STATUS parameter is not sup¬ 
plied the status defaults to pending execution. Pending execu¬ 
tion simply means that the job will execute once it has been 
registered in the queue. If the user specifies a date and time, 
the /D option (delayed execution) is assumed. The start 
date/time parameter is optional. The current date and time are 
the default. The FILE TYPE parameter is optional. The default is 
/C which indicates an OS/2 command file (.CMD). 

The SINGLE/RECURRING parameter is optional. The default 
is /S for single, which means the job is to be executed just one 
time, as opposed to recurring execution of the job. If /R is sup¬ 
plied for the SINGLE/RECURRING parameter, it indicates that 
job execution is to be recurring at the rate indicated in the RE¬ 
CURRING PERIOD parameter. If no RECURRING PERIOD para¬ 
meter is specified the default of /I is used, which indicates that 
the job will recur on a daily basis. The other RECURRING PERI¬ 
OD options are every other day, the same day each week (e.g., 
every Tuesday), the first day of the month, or the last day of the 
month. 

The NAME parameter allows the user to assign a name to the 
job. The NAME parameter is indicated by a set of double quota¬ 
tion marks. The name may be up 30 characters and contain 
imbedded spaces. While I chose to discuss these parameters in 
association with the BMSUBMIT program, the same parameters 
can be set through the PM interface when a job is set up prior 
to being submitted to the queue. 

Execution 

Up until this point I have been discussing everything but exe¬ 
cution. When the job finishes executing, Batch Manager pre¬ 
sents the user with a screen indicating whether or not the job 
executed successfully. The screen remains displayed for 60 sec¬ 
onds or until the user presses the Esc key. If no response is re¬ 
ceived within 60 seconds Batch Manager assumes that the user 
is not present and removes the screen display. In either case the 
same information that was displayed on the screen is logged to 
a file named BMJOB.LOG. In order to view the BMJOB.LOG file 
the user is instructed by the on-line documentation to use an 
external editor or the OS/2 type command to view the file. The 
capability to view the log file from within Batch Manager will 
be added to the 32-bit version of the software due out in the 
first quarter of 1993- 

On-line Documentation 

The documentation for the product is all on-line. The only writ¬ 
ten documentation for the product is a card indicating how to 
invoke the install procedure. I did not find the lack of written 
documentation to be problem. The on-line help is very thor¬ 
ough. While the addition of hypertext-type abilities within the 
on-line help would be beneficial, most users will find that they 
seldom have to refer to the help function. 

Calls to technical support were handled in a prompt and pro¬ 
fessional manner. 

I would recommend Batch Manager to anyone who has the 
need to initiate jobs on a delayed basis. Batch Manager provides 
the type of capability that has existed for two decades on the 
mainframe and minicomputer platforms. As such, it would also 
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be a good tool for those contemplating the right-sizing of main¬ 
frame and minicomputer applications to the PC/LAN platform. 

Batch Manager is produced by M. Bryce and Associates, 
Inc. and is priced at $100. M. Bryce and Associates can be 
reached at 777 Alderman Road, Palm Harbor, FL 346683. The 
telephone number is 813-786-4567 and the FAX number is 813- 
786-4785. -RB 



Guild 

Developers interested in writing applications across multiple 
platforms face the daunting task of learning multiple API’s. GUI 
(Graphical User Interface ) API’s in particular, are quite intimi¬ 
dating to the first time GUI programmer. If you are considering 
writing an OS/2 PM application, fear not. It can be done with¬ 
out having to learn the complexities of PM. Anyone that has 
ever played Solitaire or used an Etch a sketch can design a GUI 
application. 

There have been many tools developed to make writing 
GUI’s easier on the programmer. Although I was very excited 
when some of the early GUI code generators first appeared, 
the excitement quickly became disappointment when the nov¬ 
elty of the new toy wore off. I discovered many limitations that 
these early code generators presented to the application 
designer and programmer. I remained skeptical of any tool that 
claimed to be able to build an application without writing code 
until recently. Over time I adopted several tests that I use 
to determine how easily a given GUI builder can create an 
application. 

Three Tests 

The first test is the wife test. I ask my wife, a non programmer, 
to come over and design a few menus and dialog boxes. If my 
wife, or any other non-programmer can design a user interface, 
the product lives up to its claims of being easy to use. 

The second test is to recreate any demo or sample applica¬ 
tions that have been provided with the development tools. In 
the case of Guild, they have provided a very interesting sample 
program which demonstrates several of the many potential uses 
of Guild. For starters, scientific and engineering vertical appli- 
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cations which involve real-time control systems can be rapidly 
added and make it prototyped and built. Financial, Real estate, 
and Sales Database front ends can be built completely within 
the Guild Resource Builder. 

The third test is to port a given application to another plat¬ 
form. For purposes of this review I chose the Windows version 
of Guild. 

Guild is not a code generator, but rather a GUI Management 
System. Guild allows for rapid application prototyping and In¬ 
terface development. 

Guild Resource Editor (RED) 

The process for creating an application using Guild begins with 
the Guild Resource Editor (RED). 

The first task is to design the resources ( Windows, Menus, 
Dialog boxes, list boxes, buttons, etc.) that the application will 
use. 

The second task is to define the resource properties. Each re¬ 
source type has different sets of properties that apply to the giv¬ 
en resource. 

The third task is to define the actions for a given resource. 
Action definition can be broken down into events, conditions, 
and action. Events are messages that the resource responds to. 
Conditions, expressions that are evaluated when the event oc¬ 
curs. Guild has a rich set of conditions for evaluating strings, 
and numerical data. 

Action is what to do when the event occurs, if the condition¬ 
al expression is true. Possible choices for actions include such 
things as copy file, change directory, execute( an external pro¬ 
gram ), initiatetimer, invokehelp, setvar, etc. Actions are not 
limited to Guild defined actions, but can include user written 
code. 

The example I chose to write was a simple, software installa¬ 
tion tool. The beauty of Guild was not apparent until I discov¬ 
ered the actions that a software installation tool would need, 
are already available in a list of Guild defined actions. There was 
no need to write functions to create a directory or to copy files. 

As an interesting aside, guild provides built in support for 
bitmapped buttons. You can create a bitmap picture with any 
bitmap editor, and place it on a button without having to write 
a single line of code. A button control exists in three states 
(Normal, Selected, Disabled), and each may have a different 
bitmap. 

It is possible to associate a variable with each resource. Edit 
fields are an obvious example of where the programmer would 
want to know what the user has selected or entered. User writ¬ 
ten code can associate ‘C’ variables to guild variables, by regis¬ 
tering the ‘C’ variable by reference. By registering variables in a 
‘C’ module with Guild, ‘C’ modules can be written to perform 
any routine from simple to complex. 

Using the Guild Resource Editor, all resources, properties, 
and actions can be defined by clicking on toolbars, or from 
menu selections. After a few days of intensive practice, anyone 
can quickly build an application interface by simply pointing 
and clicking on selections from the available list. Context sensi¬ 
tive help is available in all areas as well. 

Guild allows the application developer to create a context 
sensitive help system in one of two ways. First it can be done in 
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the platform’s native help script language, or it can be done in 
the Guild help language. Using the Guild help language allows 
for rapid porting of the help system to other platforms. A help 
conversion utility converts guild help scripts to the target help 
language. 

The inability to isolate the interface from the internal work¬ 
ings of a program is one of the greatest challenges new pro¬ 
grammers face. A clean modular design translates into easy 
maintenance, and reduced product enhancement costs. By us¬ 
ing Guild, an interface can be designed and developed rapidly, 
and independent of the underlying code or operating system. 

Portability 

Portability is another strength of Guild. Guild is currently avail¬ 
able for OS/2, Windows, Macintosh, and Windows NT. An OSF 
Motif version of Guild for IBM RS-6000, and SUN SPARCstations 
will be available later this year. Guild is also planning to support 
OS/2 3-0. 

Resource files between OS/2, Windows, and Win NT are 
compatible, further reducing the work in producing application 
for multiple platforms. 

With Guild, the developer who wants to port an application 
will simply need to recompile and link on the target platform. 

The Guild Resource Editor provides a test capability to test 
resources as they are created and defined. 

As in all products, Guild has some room for improvement. 
The learning curve initially appears to be slightly less complex 
than PM and the version that I received for review did not have 
a tutorial to train new users. After a few calls to Tim Kessler in 
Tech Support, I was able to get my sample application working 
in a day. The Documentation is very good at explaining how to 
build an application with the exception of actually creating an 
executable. The next release of Guild should rectify these short¬ 
comings by including a tutorial that walks the user through the 
complete application building process from designing the first 
window, to executing the application. 

The size of the application was over 500K. This is because all 
of the Guild runtime code is statically linked. A DLL version is 
in the works. 

Guild provides 90 days of free support. Additional one year 
support contracts are available. The current list price for Guild 
is $895. 

Three day Guild Training Workshops are also available. The 
two days concentrate on using Guild, and the third day concen¬ 
trates on application specific issues. 

Guild Products Incorporated, can be contacted at 1301 
Shoreway Road, Belmont, California 94002; or by phone at 
(413) 593-3200, FAX (415) 595-8158. -MK 

Chron 3.0 

Chron, version 3.0 is a multithreaded, OS/2 Presentation Man¬ 
ager application that will execute OS/2, DOS or Windows pro¬ 
grams or display reminder messages at a specified time and fre¬ 
quency. Chron, version 3.0 is available as a 16-bit application 
and as a full 32-bit application. The most obvious uses for this 
utility are the automated scheduling of LAN Server applications 
or bulletin board maintenance utilities, and database mainte- 
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nance running on OS/2. I have found Chron to be useful in a 
standalone environment as well. It has been used to schedule 
reminders for meetings and to start small REXX programs to do 
routine maintenance such as backup CONFIG.SYS when the 
archive bit is on, or to run a regularly scheduled CHKDSK. 
Those users with IBM mainframe connections can use Chron to 
schedule REXX HLLAPI code to automate host 3270 interac¬ 
tions or to cut-and-paste reminders from notes received from E- 
mail systems such as OfficeVision/VM. 

Chron was originally distributed as shareware. Starting with 
this version, marketing changed from shareware to being avail¬ 
able directly from Hilbert Computing. The last version of the 
shareware code is still available on some BBSs, but is consider¬ 
ably different from the commercial release of Chron. The 16-bit 
version of Chron, version 3.0 has been available for over a year. 
The 32-bit code has been available since September of 1992. 

Installation 

Installation is fairly straightforward, although there is no instal¬ 
lation program. There are only five files to the application; one 
executable, one DLL, one help file and two message files. Both 
the 16-bit and 32-bit versions of Chron are packaged on a single 
720K diskette. The documentation does an adequate job of 
guiding OS/2 users through the installation. The documenta¬ 
tion was written for the 16-bit code. The 32-bit code is installed 
the same way, but the files are found in a subdirectory on the 
diskette called 32-BIT. The README file discusses the minor in¬ 
stallation differences for the 32-bit code. When the Chron ap¬ 
plication is started for the first time, you are prompted for the 
name of the disk file in which to place the scheduled events. 
Once that is done, you are ready to schedule events. 

Using Chron 

The user interface for Chron is well thought out and very easy 
to use. It is a CUA 89-compliant application. Events are entered 
using a non-modal, sizeable desktop window. Chron supports 
having multiple event windows open at the same time. The 
date and time are entered using a dialog that can be activated 
via the menus or by double-clicking on the date or time static 
text windows. The dialog contains a calendar with 3-D push¬ 
button days and a horizontal scroll bar for the time of day. The 
time can also be entered using the combo boxes. Messages are 
entered into a multi-line edit field. A program or message event 
can be scheduled for one time, hourly, daily, weekday, weekly, 
biweekly, monthly or yearly execution. 

The program, its parameters and the working directory are 
entered using a dialog reminiscent of the dialog found in the 
OS/2 vl.3 program manager. REXX programs are scheduled by 
starting CMD.EXE and entering the name of the REXX program 
as a parameter following a /C or /K option. This is not intuitive 
and needs to be changed. A discussion with the developer re¬ 
vealed that this will be changed in the next release currently un¬ 
der development. 

Documentation and Support 

The documentation comes as a 24 page three-hole-punched 
manual. The documentation is thorough. I particularly like the 
Quick Start section. This is a brief overview of the document 
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for those users who are familiar with OS/2 and dislike reading 
manuals. Chron is not a complex program, so the documenta¬ 
tion, though not large, is certainly enough to be able to use the 
product. Chron also includes online, hypertext help to supple¬ 
ment the printed material. 

Support from Hilbert Computing has been good. The people 
on the phone seemed friendly and knowledgable. I did get an 
answering machine a couple of times, but the calls were 
promptly returned. There is also a bulletin board established for 
customer support and an E-Mail ID for contact via CompuServe. 
Registered customers can download fixes directly from the bul¬ 
letin board as they become available. 

Summary 

Chron is a very powerful, easy-to-use PM application for sched¬ 
uling events. It is a very reliable application that is well suited 
as part of the operational support to any mission-critical data¬ 
base or server environment. For these environments, it is a 
must-have utility. Users of stand alone workstations will also 
find the product useful for automating routine tasks that would 
otherwise go undone and for scheduling reminder messages for 
recurring meetings and followup tasks. 

The packaging is low-cost and an installation utility would 
give the product a more professional feel. Except for the 
workaround for REXX programs, the application is very well 
thought out. At $69 for both 16-bit and 32-bit code, Chron, ver¬ 
sion 3-0 is a bargain. 

Chron v3.0 is produced by Hilbert Computing and is priced 
at $69. Hilbert Computing can be reached at 11022 N. Cooper, 
Olathe, KS 66061. The telephone number is Voice: (913) 780- 
5051, BBS: (913) 829-2450, CIS: 73457,365. - LB 
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- for OS/2 2.x 


- Save Printing Costs _ _ 

- Print up to 4 pages/sheet 

using Simulated Duplex - - r 

- Choose from a variety of ‘ 

page Formats and Styles 

- Print ASCII Text Files or OS/2 Clipboard Data 

- Use ATM Fonts with Unlimited Point Size Selection 

- Label/Timestamp/Page Number Documents 


Anyone who prints large text files such as reports or 
source listings will find FlexText a valuable 32-bit 
addition to their OS/2 workstation. A variety of page 
formats and borders provide the options you need for 
producing professional text-based documents. 


/) useful utility for only $49 ( limited time onfy) 

To order call Extension Software at (602) 820-0321 
921 W. Meseto Ave, Mesa, AZ 85210 
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□ Systems Sounds for OS/2 


System Sounds for OS/2 has begun shipping. The produt has 
five main features, all centering on its ability to associate an au¬ 
dio file (sound) to a pre-defmed system event. For example, us¬ 
ing audo sound to respond to a help request with, “Standby, 
starting help!” Or simply using sounds to signal the opening 
and closing of folders, system startup and shutdown and the 
drag and drop of icons. One interesting and noisy program 
twist: the capability of associating sounds to mouse buttons or 
even mouse movement. 

Another system feature is the ability to link audio to any key 
on the keyboard. The feature could prove to be a boon to avid 
game players interested in spicing things up by adding sounds 
to the appropriate keys or to operators of specialized programs 
benefiting from audio feedback. 

System Sounds for OS/22 has over 1 megabyte of sound ef¬ 
fects in Microsoft audio format including a full rage of popular 
effects from Prosonus. Sound recordings are possible at 11 kHz, 
22 kHz, 44 kHz; 8 bit or 16 bit; stereo or mono. 

Requires OS/2 multi-media extension set, or MMPM/2, which 
will be packaged with IBM’s upcomming general release of 
OS/2 2.1. BocaSoft’s System Sounds now available for OS/2 2.1 
beta users. 

Bill Stewart, BocaSoft, 407-392-7743. 


□ OS/2 2.0 Workplace Shell Programming Training Course 


Descriptor Systems now offers a training course for OS/2 2.0 
Workplace Shell programmers. This course is designed for soft¬ 
ware companies that are converting their OS/2 1 .x products to 
OS/2 Version 2.0. 

The five-day course includes intensive lecture and hands-on 
lab exercises. Topics include the System Object Module (SOM), 
Workplace Class Hierarchy, Containers, Popup Menus and Note¬ 
book Controls. Lab exercises utilize the IBM C Set/2 Compiler 
and OS/2 Programmer’s Toolkit. Attendees should be experi¬ 
enced Presentation Manager programmers. 

Courses can be held at the customer’s site or at Descriptor 
Systems’ new training center in Cedar Rapids, Iowa. On-site 
classes cost $10,000 with a limit of 24 students. 

Contact: Joel Barnum 


Descriptor Systems, PO BOX 461, Marion, LA 52302, (319) 
362-3906. 


□ DCF/2 Version 1.1 Disk Compression Facility for OS/2 


Proportional Software’s new DCF/2 is an “on-the-fly” disk com¬ 
pression facility for OS/2. The disk compression techniques 
work with all logical OS/2 2.0 disk devices and are compatible 
with virtually all disk types and sizes. IBM’s OS/2 Version 2.0 in¬ 
tegrates the Microsoft DOS and Windows PC applications world 
with the newest 32-bit applications software and features like 
true multitasking. One price for this additional power is disk 
space - anywhere from 20 to 50 megabytes depending on sys¬ 
tem options and available memory. 

The DCF/2 highly-optimized Disk Allocation Table(DAT) al¬ 
lows Compression Level 1 (CL1) algorithms to achieve near lo¬ 
cal disk access speeds. When OS/2 requests disk information, 
the DCF/2 uses the DAT to access the LDS’s and move them to a 
transport area where they are decompressed. Compression Lev¬ 
el 2 (CL2) adds to this a further layer of tokenizing, collapsing, 
and crunching and provides additional disk savings with only 
slightly slower access time. 

You use the compression level which best suits your needs: 
Files which you use on a daily basis you will want to compress 
at CL1. Other files, which you access less frequently, but you 
still want to have available for searching, reference, and so on, 
can be compressed at CL2 to recover additional space. 

List price is $129.95, To order the DCF/2, phone (800) 666-4 
OS2 or (303) 484-2665 or FAX:(800) 955-4-OS2 or (303) 484- 
2670. 

Proportional Software Corporation, 1717 Linden Lake Rd., 
Fort Collins, CO 80542, (800) 666-4672 * FAX:(800) 955-4672 


□ Magnus View 


Magus View is a Dynamic Link Library (DLL) which enables 
application developers to create programs which can render 
PostScript images, either on-screen or as printed output, 
independent of the application which produced the image. Ver¬ 
sion 1.0 of Magus View will be available for use with OS/2 
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2.0 and Microsoft Windows 31. Prices start at $495 for the 
developer’s kit. 

The Magus View DDL supports all standard PostScript display 
functions, including vector and bit-mapped fonts and the stan¬ 
dard vector graphics and clipping functions. An application 
which makes use of Magus View can display text with multiple 
fonts, text or graphics which are rotated at any orientation, 
charts and line drawings, bit-mapped images, and anything else 
which can be represented in PostScript form. Magus View ap¬ 
plications can display or print the output of virtually all word 
processing, graphics, desktop publishing, and CAD applica¬ 
tions. 

Magus View goes beyond the functionality of standard Post¬ 
Script language interpreters by offering an application pro¬ 
gramming interface specifically designed for the unique chal¬ 
lenges of displaying documents. In addition to window- 
management calls, Magus View provides a page-extraction ca¬ 
pability, which automatically retrieves and displays specified 
pages from a multi-page document. Magus View also supports 
arbitrary scaling and rotation of images, and printing to both 
PostScript and non-PostScript printers. When displaying an im¬ 
age, Magus View makes use of the fonts installed on the user’s 
computer, namely Adobe Type 1 and Type 3 fonts under OS/2, 
and both Adobe and TrueType fonts under Windows. The ren¬ 
dering capabilities of the OS/2 and Windows versions are oth¬ 
erwise identical. 

Contact: Gerry Sikora, MAGUS, PO BOX 390965, Mountain 
View, CA 94039-0965, (415) 940-1109 * FAX:(415) 940-1238 
software, I am sure you will find several features of interest. 


□ GammaTech Utilities - 32 Bit 


The GammaTech Utilities perform functions which enhance 
and complement your OS/2 workstation. This set of utilities is 
quick and easy to install using the supplied graphical installa¬ 
tion program. The utilities support the High Performance File 
System (HPFS) and the File Allocation Table (FAT) file system 
format, many of the utility functions utilize the Presentation 
Manager graphical interface while others are provided in a text 
mode (command line) format. Some utility functions are pro¬ 
vided in both PM and text mode versions. All utility functions 
support OS/2 long file names and extended attributes. 

Some of the major utility functions are as follows: HPFS Opti¬ 
mization; File Recovery; Volume Recovery; File Search; Media 
Analysis; Volume Maintenance; Data Overwrite; List Directory; 
Sector Editor; Alteration of File Attributes and Time Stamps; File 
and System Protection. 

The suggested list price is $149.00 in US funds plus shipping 
charges. Contact GammaTech for current sale price and ship¬ 
ping costs. 

GammaTech, Inc., PO BOX 70, Edmond, OK 73083, (405) 
359-1219 * FAX: (405) 359-7391. 


□ R:BASE 4.0 FOR OS/2 2.0 


MICRORIM, Inc., has begun shipping R.BASE 4.0 for OS/2 
2.0 — the only 32-bit, fully relational database management 
system (DBMS) for single- and multi-user file server-based OS/2 
systems. 

Since this latest version of R.BASE is designed specifically to 
run in the OS/2 environment, users can run multiple sessions of 
R:BASE at the same time, and can develop high-end applications 
that run in a multi-threaded environment. 

A key feature of R:BASE 4.0 is an interactive debugger (with 
full mouse support), which allows users to: step through code 
and easily locate exactly where errors occurred; display, moni¬ 
tor and change variable values interactively; and set multiple 
breakpoints to trace an application. 

Users can achieve a maximum level of data security through 
R:BASE 4.0’s 100 percent ANSI Level 2 SQL—with query-by-ex- 
ample(QBE)—which enables them to generate powerful SQL 
queries without having to know SQL syntax. 

R:BASE 4.0 for OS/2 2.0 is available through Merisel and In¬ 
gram Micro, as well as through other major domestic and inter¬ 
national distributors and resellers. The suggested retail price is 
$895 for the single-user version and $995 for the 5-user LAN 
pack. 

Contact: Kathleen Detwiler, MICRORIM, Inc., 15395 SE 30 PI, 
Bellevue, WA 98007, (206) 649-9500 * FAX:(206) 746-9350. 



SYTOS PLUS FOR OS/2 


Sytos Plus for OS/2 will also be available with the PowerTape 
backup system at the end of this month. This means OS/2 
users will be able to obtain the leading OS/2 backup software, 
together with the industry’s most popular tape backup systems, 
from Colorado Memory Systems through major national dis¬ 
tributors. PowerTape 2400 ($1295 list, including SCSI con¬ 
troller) and with the PowerTape 4000 ($1995 list, including 
SCSI controller). 

Colorado Memory Systems Inc., 800 S Taft Ave., Loveland CO 
80537, (303)669-8000 or FAX:(303)667-0921. 


□ ImageKey for OS/2 2.0 


Southern Computer Systems (SCS) announced that it has devel¬ 
oped a version of ImageKey for IBM’s OS/2 2.0, an advanced 32- 
bit operating system capable of exploiting the power of 386SX 
or higher PCs. 

“Our ImageKey software uses OS/2 2.0’s true multitasked 
processing to perform background processes, such as image de- 
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compression, ICR, or host communications, that have no de¬ 
grading effect on foreground processes, like data entry or 
ICR/OCR reject correction,” stated Dwight Martin, Director or 
Research and Development for SCS. 

“Front-ends created with Image Key are the most powerful 
yet sophisticated we’ve seen in the image marketplace. Image 
processing places great demands on a desktop operating sys¬ 
tem, and OS/2 2.0 is more than up to the task,” remarked Mark 
Golden, SCS’s Director of Marketing. 

ImageKey is the first general purpose image workstation 
product with the performance needed to support large multi¬ 
user production applications. ImageKey takes full advantage of 
its multi-threaded OS/2 platform to perform decompression, siz¬ 
ing, rotation, queuing, and optional ICR in the background with 
no degradation to the operator’s foreground activity. Built on 
SCS’s highly successful Key Entry III software, ImageKey in¬ 
cludes all of the sophisticated data entry functionality that 
made KeyEntry III a best seller. 

Southern Computer Systems, Inc., 2732 Seventh Avenue 
South, Birmingham, AL 35233, (205) 251-2985 * TELEX 755714. 



SERVER BACKUP PLUS 


Sytron Corporation, a Rexon, Inc. subsidiary and leading devel¬ 
oper of high-performance backup and archival software solu¬ 
tions, announced today the release of Server Backup plus, a 
NetWare Loadable Module (NLM) backup utility, co-developed 
by Sytron and Novell. 

Server Backup plus is compliant with Novell’s Storage Man¬ 
agement Services (SMS) and SMS Data Format (SMSDF) software 
technologies. “Novell is pleased to see Sytron’s support for Stor¬ 
age Management Services (SMS) and the SMS Data Format,” said 
Jan Newman, executive vice president and general manager, 
NetWare Systems Group, Novell, Inc. “Server Backup plus fully 
supports the forthcoming Novell Target Service Agents (TSAs) 
which will give SMS-compliant NLMs the ability to backup DOS, 
Windows, OS/2 and Macintosh clients ” 

By supporting SMS, Server Backup plus is able to read all 
tapes created with SBACKUP, the utility that ships with Novell 
NetWare v3.11. Also, all NetWare bindery files, security infor¬ 
mation and name spaces including DOS, OS/2, NFS, FTAM and 
Macintosh are fully backed up. Compliance to SMS ensures 
compatibility and interoperability with NetWare file systems for 
today and in the future. 

PRODUCT Highlights — Server Backup plus is an easy to use NLM 
backup utility offering advanced functionality beyond Novell 
NetWare’s Server Backup (SBACKUP) utility. Server Backup 
plus backs up and restores data from tape drives attached to 
Novell NetWare v311 file servers. Running as an NLM, Server 
Backup plus provides high speed backup, fast file restores, im¬ 
proved security and centralized administration of network 


backup procedures. In addition to the features found in SBACK¬ 
UP, Server Backup plus provides the following: 

• File Compare (including auto-compare with backup opera¬ 
tions) 

• Scheduling of backup operations 

• Saving of commonly-run backup operations as Procedures 

• Ability to run remotely from any DOS workstation on the 
network 

“Server Backup plus is an excellent choice for the network 
manager who needs the performance of a server-based NLM at 
a very competitive price,” stated Cimarron Boozer, vice presi¬ 
dent of marketing at Sytron. “Sytron has utilized its experience 
developing client-based backup solutions to deliver its first serv¬ 
er-based NLM product,” added Boozer. 

Sytron Corporation, 134 Flanders Rd., Westboro, MA 01581, 
(508) 898-0100 • FAX.*508-898-2677. 


□ Softbridge BASIC Language 


Softbridge Inc. announced two new developments in its line 
of Softbridge BASIC Language (SBL) embedded BASIC script¬ 
ing products. The new products include SBL OS/2 and SBL 
3.0, an object-oriented version of SBL. SBL, the only commer- 
cially-available embeddable scripting language, enables devel¬ 
opers to add an industry-standard programming language to 
their products without having to design and maintain their 
own. 

Initially introduced for Windows applications, SBL will port 
OS/2 with the release of SBL OS/2, slated to ship later this quar¬ 
ter. “We recognize the viability of the OS/2 market, and have 
had considerable demand from developers who need to add ex¬ 
tensibility to OS/2 apps,” said Jerry Bedrick General Manager for 
SBL. “SBL OS/2 should provide our customers with more devel¬ 
opment options, and will help expand our market.” 

SBL 3 0, to ship in 2Q93, will enable developers to in¬ 
clude object-oriented programming capability to their appli¬ 
cations. SBL 3.0 adds support for object-oriented features 
into BASIC including nested objects, inheritance, and new 
syntactic additions compatible with Visual BASIC 2.0. 

SBL is syntax-compatible with Visual BASIC, and includes fea¬ 
tures such as hooks for a debugger, single stepping, dialog box¬ 
es, error handling, and application data types. Developers em¬ 
bedding SBL in their products can readily expand on the core 
functions provided in the BASIC language by adding applica¬ 
tion-specific functions and dialog boxes. 

SBL is implemented as a Dynamic Link Library (DLL). Its 
full-featured API lets it become a seamless extension of any Win¬ 
dows or OS/2 application. 

Contact: Maureen Rogers, Softbridge Inc., 125 Cambridge 
Park Dr., Cambridge MA 02140, (617) 576-2257 * FAX (617) 
864-7747. 
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Ql LANIord LAN Management Software 


Microcom Inc. (NASDAQ SymboLMNPI), headquartered in Nor¬ 
wood, MA, announced today its plans to market a new version 
of its LANIord LAN management software for IBM’s LANfocus 
Management/2 platform. The new product, LANIord LM/2, will 
provide users with a fully integrated set of applications for man¬ 
aging DOS, MS-Windows and OS/2 LAN-based PCs within the 
enterprise architecture defined by IBM for management of dis¬ 
tributed networks. 

Under the non-exclusive agreement, Microcom will develop 
a version of LANIord (LANIord LM/2), which will utilize IBM’s 
LANfocus Manage/2, View/2, Agents/2, Agents Extended/2 and 
LAN Server software, as well as IBM’s OS/2-based Presentation 
Manager (PM) interface. In addition, the two companies intend 
to cooperate on joint marketing of the product to IBM cus¬ 
tomers and resellers. 

The new product will provide applications for automatic, dy¬ 
namic PC hardware and software inventory; LAN and PC moni¬ 
toring; statistics monitoring; remote configuration support; 
software metering; and data export and reporting. 

At the same time, Microcom will add support for PCs run¬ 
ning OS/2 on LANs, and extend LANIord s network operating 
system capabilities to include LAN Server, as well as NetWare 
and Lan Manager. In addition, LANlord’s management console 
will be ported to IBM’s PM interface. 

LANIord LM/2 is expected to be commercially available by 
mid-1993. 

Contact:Emerick Woods, Microcom CST Group, (914) 968- 
2300, MICROCOM, 500 River Ridge Dr., Norwood, MA 02062- 
5028, (617) 551-1000 * FAX:(6l7) 551-1869. 


□ BenchTech for OS/2 


In today’s personal computer marketplace, performance claims 
are abundant. Very often, however, there is little practical evi¬ 
dence to back up these claims. The advent of the Graphical 
User Interface (GUI) has changed the way the personal com¬ 
puter industry must look at computer performance. IBM OS/2 
Version 2.0, the industry’s most advanced operating system, re¬ 
quires considerable computer resources to take advantage of its 
power. Individuals and companies alike need a tool to help 
them tradeoff performance versus price. 

BenchTech for OS/2 is a powerful performance measurement 
tool, containing a suite of 32 bit benchmarks designed specifi¬ 
cally for OS/2 Version 2.0 and beyond. OS/2 2.0 performance 
can vary greatly between one computer design and another. 
Even though all systems that run OS/2 2.0 are based on the Intel 
80386 architecture, the observed performance is also depen¬ 
dant on the cache design (if the system uses a cache), the num¬ 


ber of wait states required, the video system, the disk drive and 
many other factors. 

Contact:Chris Parsons, Synetik Systems, 2210 Highway 6 & 
50, Ste. 204, Grand Junction, CO 81505-9406, (303) 241-1718. 



NORTON COMMANDER FOR OS/2 


Symantec Corporation (NASDAQ:SYMC) today announced The 
Norton Commander for OS/2, the industry’s first third-party file 
management utility software for OS/2. The Norton Commander 
for OS/2 streamlines and simplifies file management, offers 
powerful file finding capabilities and provides network menu- 
ing support for corporate customers. 

FILE Management — Norton Commander for OS/2 provides a fast 
and powerful way for OS/2 users to manage their HPFS (high 
performance file system) FAT (file allocation table) files in full 
graphical mode right from the desktop. File management 
operations are streamlined and integrated into one central 
window and are easily accessible with a keystroke or mouse 
click. With Norton Commander’s graphic tree and file list display, 
users can instantly see the contents of folders and drives. 

The global file find utility allows the user to search for 
files, including wildcards, by name or extension across a 
hard disk and display them in a scrollable list. The files can 
then be launched or viewed, or the user can go to the folder 
where the file is located. Multiple folders can be viewed and 
compared, and files can be instantly moved from one folder to 
another. 

With Norton Commander, OS/2 users are able to perform 
common tasks such as finding, organizing and accessing files 
and programs with a minimum number of steps. Users can 
quickly view, edit, copy, rename, move and delete files or 
groups of files using a few keystrokes or mouse clicks. 

APPLICATIONS Menu — The Norton Commander’s configurable 
Norton Menu lets the user launch frequently used applications 
with a single keystroke or mouse click. Users can add to the list 
simply by dragging-and-dropping applications to the Norton 
menu. The Norton Menu can be used to create corporate-wide 
read-only menus that can be centrally administered by any OS/2 
compatible network. 

Menus can be nested within menus for more efficient organi¬ 
zation of applications. Additionally, DOS, Windows, OS/2 and 
OS/2 Presentation Manager applications can be preconfigured 
to appear minimized, maximized or normal window size upon 
startup. 

Additional Features — With Norton Commander for OS/2, users 
can execute DOS and OS/2 commands from a pop-up command 
line interface. The file management interface can be configured 
in two easy to use, familiar modes - the Norton Commander for 
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DOS or the Norton Desktop for DOS or Windows - making file 
management in OS/2 effortless. 

Pricing and Availability — The Norton Commander for OS/2 is 
available at a suggested retail price of $149. It requires OS/2 
2.0, 80386SX or higher 32-bit microprocessor, 500K of free 
hard disk space and a minimum of 4MB of memory. 

SYMANTEC, 10201 Torre Ave., Cupertino, CA 95014-2132, 
(408) 253-2132 * FAX (408) 253-4092. 


□ SYMANTEC Announces Two New Versions of Zortech C++ 


Compiler Offers AT&T C++ 3.0 Support, Windows-Hosted De¬ 
buggers and Whitewater Resource Toolkit; OS/2 2.0 Version 
also available. 

The new products are fully compliant with AT&T CFRONT 
C++ and ANSI C and offer full 32-bit and advanced numerics 
support. Zortech C++ 3.1 offers true implementation of tem¬ 
plates. In addition, Zortech C++ is the only compiler on the 
market that conforms to the IEEE-754 floating point standards 
and the NCEG 91-015 draft for numerical extensions. 



ZORTECH C++ FOR OS/2 2.0 


Zortech C++ for OS/2 2.0 offers optimized, native 32-bit code 
generation for larger, faster programs. A mature, global optimiz¬ 
er ensures fast, small code. In addition, Zortech is tightly inte¬ 
grated with IBM’s Workframe/2 to allow customers to use the 
graphical project organization capabilities it provides. 

“Part of the fantastic worldwide acceptance of OS/2 version 
2.0 is due to the object-oriented technology which is an integral 
part of this new operating system,” said John Soyring, IBM’s di¬ 
rector of software development programs. “The introduction of 
Symantec’s Zortech C++ compiler for object-oriented applica¬ 
tion development and IBM OS/2 version 2.0 should provide a 
powerful combination and contribute to the growing portfolio 
of innovative 32-bit OS/2 applications.” 

Zortech C++ for OS/2 2.0 is immediately available for $499 
for new users and $249 for registered users of Zortech C++. 
The product is available through authorized Symantec resellers, 
or direct from Symantec. Customers can obtain further infor¬ 
mation by calling (800) 441-7234 or (408) 252-3570. 


SYMANTEC, 10201 Torre Ave., Cupertino, CA 95014-2132, 
(408) 253-2132 * FAX (408) 253-4092. 



MERCURY TESTRUNNER 


Mercury TestRunner is an automated software testing system 
that dramatically accelerates the software testing process. Used 
in quality assurance as well as software development, TestRun¬ 
ner delivers faster, more effective testing, lower software lifecy¬ 
cle costs, and higher application quality. 

Test Programming — Every TestRunner script is a high level 
software program that executes tests automatically. Scripts are 
written in Mercury’s Test Script Language (TSL), a fully 
functional C-like language with special testing features. By 
programming and recording in the same script, you can tailor 
automated tests to perform any operation you need. 

OUTPUT Synchronization — TestRunner uses Mercury’s patented 
Output Synchronization technology to control automated 
replay. Like a human operator, TestRunner waits for the tested 
system to display a visual output cue. Now matter how quickly 
or slowly the output is presented, TestRunner recognizes 
exactly when your application is ready to continue. Only then 
does it execute the next input. 

Test Recognition — TestRunner can recognize and read text 
output right off the display screen. This facility lets TestRunner 
interpret output based on content, just as a human user would. 
Using text recognition, you can create context sensitive tests — 
tests that can decide which operations to perform next based 
on the text displayed by the application. As a result, your tests 
can automatically adapt to application changes throughout the 
software lifecycle. 

Automatic Verification — TestRunner compares screen output 
with expected results in real time. It automatically verifies: 
Display Graphics 

Output files 
On-screen text 

A detailed execution report is issued at the end of every test. 
For every mismatch found, TestRunner captures and stores the 
actual output image. 

Mercury Interactive Corporation, 3333 Octavius Dr., Santa 
Clara, CA 95054, (408)987-0100 * FAX:(408) 982-0149. 
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IX THE THEM 


A Mhere are all the OS/2 ap- 
plications?” cry the OS/2 
wt 1 W users. That’s a really good 
question. The problem with OS/2 applica¬ 
tion development was that nobody could 
have predicted or would have believed 
that OS/2 would sell over two million 
copies by the end of 1992. Consequently, 
some of the larger software developers re¬ 
ally didn’t begin to start work on prod¬ 
ucts until well after OS/2 2.0 began to 
ship. For the small shops, the tools pro¬ 
vided were at first too expensive; but 
when IBM released a $15 CDROM with 
tools on it, were flooded with requests 
(the initial run of 4,000 copies was sold in 
in a few days). 

So, given this late start, OS/2 applica¬ 
tions have only begun to start to appear. 
But developers often make mistakes in 
how they handle their OS/2 products, and 
this can cost them. For example, De- 
Scribe’s word processor (Describe 4.0) is 
an excellent product, and it uses OS/2 fea¬ 
tures such as threads. However, there is 
no upgrade path for users of existing 
word processors. Consequently, you’ll 
have to pay $495 to buy Describe. This 
requirement to pay full price is prevent¬ 
ing Describe from reaching its full sales 
potential. When competitive products 
like Ami Pro for OS/2 come out, you can 
be sure that Lotus will offer an upgrade to 
new users, as is the company’s practice 
now. If you can get $ 150 from a user to 
switch to your product now, he is less 
likely to pay another $ 150 to switch back 
to a competitor’s product. 

A second common mistake is to price 
all OS/2 software much higher than Win¬ 
dows or DOS software. You can’t do this. 
If you want to sell in the OS/2 market, 
you have to compete with the cheaper 
Windows and DOS applications on price. 
We’ve all seen how ISV’s charge one price 
for a Windows product, then turn around 
and charge fity percent more for the OS/2 
version, and then wonder why their OS/2 
version isn’t getting the market penetra¬ 


tion they hoped for. This goes hand in 
hand with having a good upgrade policy. 

A third common mistake is assuming 
that a straight port of an existing Win¬ 
dows or DOS app without adding func¬ 
tionality is going to result in good OS/2 
sales. If a competitor is going to take ad¬ 
vantage of OS/2’s multitasking and object- 
oriented capabilities, how is your app go¬ 
ing to compete without similar features? 
Look at Computer Associates. The suite of 
applications they are about to release for 



OS/2 all take advantage of OS/2’s capabil¬ 
ities. A quick port (using WLO or similar 
tools) is fine for the short term, but as 
more and more 32-bit applications that 
use the power of OS/2 appear, the 16-bit 
straight ports will begin to look dated by 
comparison. And the performance advan¬ 
tage of using threads and 32 bits is easily 
demonstrated. Why should a user be con¬ 
tent with Windows and DOS apps when 
they can get an OS/2 app that is better ? 

In addition, developers should choose 
the appropriate application to develop. 
Look at Symantec as an example. They de¬ 
veloped Norton Desktop for OS/2 as a 
means of testing the OS/2 market to see if 
it was viable or not. The problem is, Nor¬ 
ton Desktop really doesn’t offer lots of ex¬ 
tra functionality beyond the existing DRI¬ 


VES icon. There are also freeware utilities 
which are, frankly, better than Norton 
Desktop for OS/2. If you look at DOS and 
Windows users, you’ll see that they get 
three things: a memory manager like 
QEMM (not needed with OS/2); disk com¬ 
pression (Stac Electronics is going to 
make a killing with Stacker for OS/2); a 
file utility/backup program. Well, in 
Symantec’s case, they make the Norton 
Utilities, which certainly fits the third cat¬ 
egory. So why didn’t Gordon Eubanks 
(CEO of Symantec) tell his programmers 
to develop Norton Utilities for OS/2? I 
mean, how much competition is there in 
the area of file backup/utilities right now? 
Fortunately, sales of Norton Desktop for 
OS/2 are exceeding Symantec’s expecta¬ 
tions, so I have high hopes that I’ll even¬ 
tually be able to get a file utility program. 

The final problem comes in promoting 
an OS/2 product. Why is it that so many 
software catalogs have virtually no OS/2 
listings? Are no ISV’s letting retailers 
know about their products? ISVs must 
put some advertising dollars into their 
OS/2 products so that they do appear in 
places like Egghead or Software Etc. 

Of course, a certain amount of the 
blame goes to IBM, whose marketing cam¬ 
paign has been abysmal. Fortunately, IBM 
is beginning to realize that the fate of 
OS/2 in linked with that of the ISV’s, and 
so joint ads (like the recent IBM/Lotus 
ads) are beginning to appear. I wouldn’t 
be the least bit surprised to see an OS/2 
applications development contest. 

Finally, there is one important, com¬ 
pelling factor toward making an applica¬ 
tion successful: making it a better applica¬ 
tion. A good example is Digitalk’s PARTS 
Workbench for OS/2. It is a powerful and 
versatile tool to build applications with, 
which no Windows or DOS product that I 
know of can equal. That is the real power 
of OS/2: to make the best applications in 
the world. Period. 

Eric Pinnel 
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An OS/2 Personal Information Manager 



The Arcadia Workplace Companion (WPC) is a set 
of productivity tools designed specifically for the 
OS/2 Workplace Shell environment from the ground 
up! It adheres to Common User Access (CUA) '91 
guidelines and completely integrates its various 
components in an object-oriented fashion. The WPC 
exploits all of the powerful new 
controls found within OS/2 2.0 
including notebooks, containers, 
sliders, value sets, and spin buttons. 


Clock/Calendar. This module contains a month 
calendar, a full-year calendar, Julian date, 
analog/digital clock, international times, holidays, 
and more! It allows you to customize its many 
features, such as setting your own alarms and 
adding new cities to the international cities list. 


Everything necessary to schedule 
the days events, keep track of 
appointments, and manage 
business contacts is represented 
graphically. The Workplace 
Companion contains a clock/calendar module, an 
appointment book, a telephone/address book (with 
phone log), a notepad, a to-do list, and other 
productivity features. 


Arcadia 

Technologies 

Inc. 


OS/2, CUA, IBM are registered trademarks of International Business 
Machines, Corporation. Arcadia Workplace Companion is a trademark of 
Arcadia Technologies, Incorporated. 


Finally, an 
Intuitive personal 
Information 
management tool 
for 

OS/2 2.0! 


Appointment Book. The 

Appointment Book is an excellent 
way to schedule your day's events. 
Appointments may be added by 
clicking on the time you wish to 
schedule and typing a description. 



Telephone/Address Book. This 
module is a convenient way to store 
the name, numbers, and addresses of all your 
important contacts. The built-in Phone Log and 
Follow-up feature make tracking phone calls easy. 


735 West Duarte Road, Suite 207 
Arcadia, CA 91007 


Tel: (818)446-6945 
Fax: (818) 447-4212 





















































































_ YOUR WAIT IS OVER! _ 

Now there’s a graphical development and 
decision support system that combines 
unparalleled data access and reporting with the 
stability and multitasking power of OS/2 2.0. 

It’s called PM/FOCUS from Information 
Builders, a leader in application development 
tools for almost every environment. 

EXPERIENCE OUR EASE AND SPEED 

PM/FOCUS offers a rich graphical toolset for 
feist, easy application development with a 
minimum of coding. All application components, 
including databases, procedures and forms 
become simple graphical objects that can be 


INTRODUCING 

PM/FOCUS 

controlled by mouse-driven “drag and drop.” 

Built-in list boxes, check boxes, radio 
buttons, type fonts and other graphical tools 
allow you to create attractive GUIs that are so 
intuitive, they’re a snap for even the most 
unsophisticated end users. 

POWERFUL REPORTING FEATURES 

PM/FOCUS offers the most powerful reporting 
language of any product on the market today. 
And building reports is a breeze. You simply 


transform database fields, record selections, and 
report headings and footers into selectable 
objects. Even complex sorts are available at the 
touch of your mouse. 

_DELIVER GREAT OS/2 GUIs_ 

Get the promise of OS/2 now. Make PM/FOCUS 
your corporate standard for sensational GUI 
application development. For more information, 
or to attend a free seminar... 

Call 800-969-INFO 

In Canada call 416-364-2760 



OS/2 is a registered trademark of International Business Machines Cap. PM/FOCUS is a registered trademark of Information Builders, Inc., 1250 Broadway, NY, NY 10001 


















































Let Gpf write the GUI you design 


Gpf 


SYSTEMS, INC. 




Using the powerful point and click visual programming environment of Gpf*, you can 
prototype, test and generate a complete OS/2 PM GUI in a few hours or days rather 
than the weeks or months required to hand code the same design. Even a relatively 
simple GUI can require writing thousands of lines of code, but with Gpf you simply 
draw your user interface on the screen. The integrated dialogue editor of Gpf permits 
actions and context sensitive help to be linked to controls as you create them. Gpf then 
generates error free ANSI C, complete with embedded SQL statements. 

Gpf is optimized to take full advantage of OS/2 PM, the most powerful and robust GUI 
system available. Since Gpf code directly accesses the PM API, there is no run time 
module to distribute with your application and no added overhead or royalties. 

Gpf keeps the entire design definition in one file. This means single point mainte¬ 
nance for easy updating and archiving. From this file, Gpf generates the C source 
file as well as .H, .RC, .IPF, DEF, .IDS, .MAK, etc. 

Gpf 2.0 Supports: 

32 Bit Code Generation and CUA ’91 Controls. 

Simple and direct linkage of the interface to program logic, built 
in or user defined functions. 

Direct association of help screens with controls and complete 
integration into the PM Help Presentation Facility. 

Flexible use of Presentation objects (fonts, colors, etc.) with 
controls and windows (client area and frame). 

Simple inclusion of bitmaps for use on About screens, user- 
defined buttons, and menu or pulldown entries. 

Automatic embedded SQL statements to read OS/2 Database 
"Manager tables directly into combo or list boxes. 

Multi-thread programming. 

Multiple source file generation. 

Automatic creation of controls that scale with window size. 
Inclusion of user defined controls. 


Try us out 

Order: Gpf for just $995.°° and GpfTools for $195.°° or 
SPECIAL both for $1,140.°° (A $50.°° savings) 

Call Gpf Systems Inc. at: 

(203) 873-3300 or (800) 831-0017 - fax (203) 873-3302. 

Free demo software available 

30 Falls Rd„ P.O. Box 414, Moodus, CT 06469 

Information on International Distributors available - call Gpf Systems Inc. 

* GUI Programming Facility 















